Skip to main content
Hitachi Vantara Knowledge

Add CIFS share access authentications

Adds CIFS share access authentications.

HTTP request syntax (URI)
POST <base_URI>/v7/storage/filesystem-shares/cifs/{cifsObjectId}/authentications
Name Type Required Values Description
cifsObjectId URI_PARAM Y string Object ID of the CIFS share.
cifsAuthentications BODY Y object Array of CIFS authentication objects to be added to the CIFS share. Each CIFS authentication object should omit the encodedName attribute. See the examples for the correct syntax
Return codes
Code Data Description
201 No Data CIFS share access authentications are added successfully
400 No Data Missing or invalid request contents.
404 Error Message Requested resource not found.
500 Error message Error associated with the storage system.
501 No Data Server has not implemented the request operation on the resource.

Any HTTP status code other than 201 indicates that the API did not complete successfully.

Request example
curl -vk -H "X-Api-Key: zrxvSDAv9x.RIP4gkmKarG3beF.or.4Tc2im7oeqYN88C9XPGHxbXC" 353a3a3a65646430653862322d353462612d313164312d393131622d346265653366616163613362/authentications -d '{"cifsAuthentications":[{"type":"GROUP", "permission":56, "name":"current owner"},{"type":"GROUP", "permission":56, "name":"Administrators"}]}' -X POST
Response example
HTTP/1.1 201 Created
    "cifsAuthentications" : [
         "encodedName" : "4255494c54494e5c41646d696e6973747261746f7273",
         "name" : "BUILTIN\\Administrators",
         "permission" : 56,
         "type" : "ALIAS"
         "encodedName" : "4255494c54494e5c43757272656e74204f776e6572",
         "name" : "BUILTIN\\Current Owner",
         "permission" : 56,
         "type" : "ALIAS"
   "uri" : ""


  • Was this article helpful?