Adds CIFS share access authentications.
HTTP request syntax (URI)
POST <base_URI>/v7/storage/filesystem-shares/cifs/{cifsObjectId}/authentications
Parameters
| 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" https://172.17.57.75:8444/v7/storage/filesystem-shares/cifs/ 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" : "172.17.57.88:8444/v7/storage/filesystem-shares/cifs/363a3a3a39353764393634652d383566302d313164312d393336342d346265653366616163613362/authentications"
}