Update privileges for a local, or Active Directory user or group and SVM
Updates the privileges for a specified local or Active Directory user or group and SVM, replacing any existing privileges with the new ones you specify. Use this endpoint to manage user access and permissions efficiently within your storage environment.
HTTP method and endpoint
PATCH /protocols/cifs/users-and-groups/privileges/{svm.uuid}/{name}
Introduced in
ONTAP 9.9
Usage notes
Updates privileges of the specified local or Active Directory user or group and SVM.
Important note
-
Specified privileges will replace all the existing privileges associated with the user or group.
-
To reset privileges associated with the user or group, specify the privileges list as empty.
Related ONTAP commands
-
vserver cifs users-and-groups privilege reset-privilege
Parameters
| Name | Type | In | Required | Description |
|---|---|---|---|---|
name |
string |
path |
True |
Local or Active Directory user or group name. |
svm.uuid |
string |
path |
True |
UUID of the SVM to which this object belongs. |
Request Body
| Name | Type | Description |
|---|---|---|
privileges |
array[string] |
An array of privileges associated with the local or Active Directory user or group. The available values are:
|
svm |
Example request
{
"privileges": [
"string"
],
"svm": {
"name": "svm1",
"uuid": "02c9e252-41be-11e9-81d5-00a0986138f7"
}
}
Response
Status: 200, Ok
Error
Status: Default
ONTAP Error Response Codes
| Error Code | Description |
|---|---|
655673 |
Failed to resolve the user or group. |
655730 |
The specified local user to which privileges are to be associated to does not exist. |
Definitions
See Definitions
href
| Name | Type | Description |
|---|---|---|
href |
string |
_links
svm
| Name | Type | Description |
|---|---|---|
name |
string |
The name of the SVM. |
uuid |
string |
The unique identifier of the SVM. |
user_group_privileges
| Name | Type | Description |
|---|---|---|
privileges |
array[string] |
An array of privileges associated with the local or Active Directory user or group. The available values are:
|
svm |
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. |