sidebar | permalink | keywords | summary |
---|---|---|---|
sidebar |
workflows/wf_nas_fs_apply_permissions.html |
nas, file security, sacl, dacl, permissions, apply permissions |
You can apply a new security descriptor to a specific file or folder. |
You can apply a new security descriptor to a specific file or folder.
HTTP method and endpoint
This REST API call uses the following method and endpoint.
HTTP method | Path |
---|---|
POST |
/api/protocols/file-security/permissions/{svm.uuid}/{path} |
Processing type
Asynchronous
Additional input parameters for curl examples
In addition to the parameters common with all REST API calls, the following parameters are also used in the curl example in this step.
Parameter | Type | Required | Description |
---|---|---|---|
$SVM_ID |
Path |
Yes |
This is the UUID of the SVM containing the file. |
$FILE_PATH |
Path |
Yes |
This is the path to the file or folder. |
Curl example
curl --request POST --location "https://$FQDN_IP/api/protocols/file-security/permissions/$SVM_ID/$FILE_PATH?return_timeout=0" --include --header "Accept */*" --header "Authorization: Basic $BASIC_AUTH" --data '{ \"acls\": [ { \"access\": \"access_allow\", \"advanced_rights\": { \"append_data\": true, \"delete\": true, \"delete_child\": true, \"execute_file\": true, \"full_control\": true, \"read_attr\": true, \"read_data\": true, \"read_ea\": true, \"read_perm\": true, \"write_attr\": true, \"write_data\": true, \"write_ea\": true, \"write_owner\": true, \"write_perm\": true }, \"apply_to\": { \"files\": true, \"sub_folders\": true, \"this_folder\": true }, \"user\": \"administrator\" } ], \"control_flags\": \"32788\", \"group\": \"S-1-5-21-2233347455-2266964949-1780268902-69700\", \"ignore_paths\": [ \"/parent/child2\" ], \"owner\": \"S-1-5-21-2233347455-2266964949-1780268902-69304\", \"propagation_mode\": \"propagate\"}'
JSON output example
{ "job": { "uuid": "3015c294-5bbc-11eb-9c4e-0050568e8682", "_links": { "self": { "href": "/api/cluster/jobs/3015c294-5bbc-11eb-9c4e-0050568e8682" } } } }
Perform the workflow Get job instance and confirm the state
value is success
.