Update privileges for a local, or Active Directory user or group and SVM
Updates privileges for a local or Active Directory user or group within an SVM. Use this endpoint to modify access rights as needed to meet organizational security policies or role requirements.
HTTP method and endpoint
PATCH /protocols/cifs/users-and-groups/privileges/{svm.uuid}/{name}
Introduced in
ONTAP 9.10
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. |