POST /roles
Use this method to create a custom user role.
Authentication
Authentication with username and password is required.
Request URL
POST https://{management_server_IP}/roles
Query parameters
None
Request body
| Attributes | Required / Optional | Type | Description | ||
|---|---|---|---|---|---|
| description | Required | String | Role description | ||
| existingRole | Optional | String | ID of the existing role on which to base the new role. All privileges in this existing role are added to the new role. To obtain the role ID, use the GET /roles method. | ||
| name | Required | String | Name of the role. To obtain the names of predefined and custom roles, use the GET /roles method. | ||
| privileges | Required | Array of string | List of URIs that identify the IDs of privileges that are associated with the role (for example, /privileges/3) To obtain a list of all privilege IDs, use the GET /privileges method. | ||
| reserved | Required | String | Indicates if the role is reserved and cannot be used to create new role groups or assigned to new users. This can be one of the following values.
| ||
The following example create a custom role.
{
"description": "A role that allows a user to…",
"existingRole": "1007",
"name": "lxc-admin",
"privileges": ["/privileges/3","/privileges/5"],
"reserved": false
}
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. |
| 404 | Not found | A specified resource cannot be found. 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
| Attributes | Type | Description | ||
|---|---|---|---|---|
| result | String | Results of the request. This can be one of the following values.
| ||
| messages | Array of objects | Information about one or more messages | ||
| id | String | Message identifier of a returned message | ||
| text | String | Message text associated with the message identifier | ||
| explanation | String | Additional information to clarify the reason for the message | ||
| recovery | Array of objects | Recovery information | ||
| text | String | User actions that can be taken to recover from the event | ||
| URL | String | Link to the help system for more information, if available | ||
The following example is returned if the request is successful.
{
"result": "success",
"response": {},
"messages": [{
"id": "FQXHMSE0001I",
"text": "The request completed successfully.",
"recovery": {
"text": "Information only. No action is required.",
"URL": ""
},
"explanation": ""
}]
}
Give documentation feedback