PUT /resourceAccessControl
Use this method to modify the current access-control settings.
Note
Only users with lxc-supervisor or lxc-security-admin authority can modify the access-control settings.
Authentication
Authentication with username and password is required.
Request URL
PUT https://{management_server_IP}/resourceAccessControl
Query parameters
None
Request body
Attributes | Required / Optional | Type | Description | ||
---|---|---|---|---|---|
defaultRoleGroups | Optional | Array of strings | List of role groups that are authorized by default to view and manage all devices when the devices are initially managed. After a device is managed by Lenovo XClarity Administrator, you can change the authorized role groups for that device. (see PUT /chassis/{uuid}, PUT /nodes/{uuid}, PUT /storage/{uuid}, and PUT /storage/{uuid}). | ||
publicAccess | Optional | Boolean | Indicates whether the resource can be accessed by all role groups. This can be one of the following values.
| ||
resourceAccessControlEnabled | Optional | Boolean | Indicates whether access control is enabled. This can be one of the following values.
|
The following example disables access control.
{
"resourceAccessControlEnabled": false
}
The following example enables access control and sets the default role groups for all devices.
{
"resourceAccessControlEnabled": true,
"defaultRoleGroups": ["lxc-hw-admin","lxc-os-admin"]
}
Response codes
Code | Description | Comments |
---|---|---|
200 | OK | The request completed successfully. |
400 | Bad Request | A query parameter or request attribute is missing or not valid, or the operation is not supported. A descriptive error message is returned in the response body. |
401 | Unauthorized | The user cannot be authenticated. Authentication has not been provided or has failed. A descriptive error message is returned in the response body. |
403 | Forbidden | The orchestrator server was prevented from fulfilling the request. A descriptive error message is returned in the response body. Ensure that you have privileges to perform the request. |
404 | Not found | A specified resource cannot be found. A descriptive error message is returned in the response body. |
409 | Conflict | There is a conflict with the current state of the resource. A descriptive error message is returned in the response body. |
500 | Internal Server Error | An internal error occurred. A descriptive error message is returned in the response body. |
Response body
None
Give documentation feedback