Delete a privilege tuple from the role
Removes a privilege tuple from a role, updating the role's access by deleting specified permissions. This operation is typically used when you need to adjust or restrict access levels for security management purposes.
HTTP method and endpoint
DELETE /security/roles/{owner.uuid}/{name}/privileges/{path}
Introduced in
ONTAP 9.6
Usage notes
Deletes a privilege tuple (of REST URI or command/command directory path, its access level and an optional query) from the role. The REST URI can be a resource-qualified endpoint. Currently, the only supported resource-qualified endpoints are /api/storage/volumes/{volume.uuid}/snapshots and /api/storage/volumes//snapshots. "" is a wildcard character denoting "all" volumes.
Required parameters
-
owner.uuid- UUID of the SVM which houses this role. -
name- Name of the role to be updated. -
path- Constituent REST API path or command/command directory path to be deleted from this role. Can be a resource-qualified endpoint (example: /api/storage/volumes/43256a71-be02-474d-a2a9-9642e12a6a2c/snapshots). Currently, resource-qualified endpoints are limited to the "snapshots" endpoint: /api/storage/volumes/{volume.uuid}/snapshots and /api/storage/volumes//snapshots. "" is a wildcard character denoting "all" volumes.
Related ONTAP commands
-
security login rest-role delete -
security login role delete
Parameters
| Name | Type | In | Required | Description |
|---|---|---|---|---|
owner.uuid |
string |
path |
True |
Role owner UUID |
name |
string |
path |
True |
Role name |
path |
string |
path |
True |
REST API path or command/command directory path |
Response
Status: 200, Ok
Error
Status: Default
ONTAP Error Response Codes
| Error Code | Description |
|---|---|
5636169 |
Specified URI path is invalid or not supported. Resource-qualified endpoints are not supported. |
5636170 |
URI does not exist. |
5636172 |
User accounts detected with this role assigned. Update or delete those accounts before deleting this role. |
5636173 |
This feature requires an effective cluster version of 9.6 or later. |
5636184 |
Expanded REST roles for granular resource control feature is currently disabled. |
5636185 |
The specified UUID was not found. |
5636186 |
Expanded REST roles for granular resource control requires an effective cluster version of 9.10.1 or later. |
13434890 |
Vserver-ID failed for Vserver roles. |
13434893 |
The SVM does not exist. |
| Name | Type | Description |
|---|---|---|
error |
Example error
{
"error": {
"arguments": [
{
"code": "string",
"message": "string"
}
],
"code": "4",
"message": "entry doesn't exist",
"target": "uuid"
}
}
Definitions
See Definitions
error_arguments
| Name | Type | Description |
|---|---|---|
code |
string |
Argument code |
message |
string |
Message argument |
error
| Name | Type | Description |
|---|---|---|
arguments |
array[error_arguments] |
Message arguments |
code |
string |
Error code |
message |
string |
Error message |
target |
string |
The target parameter that caused the error. |