System Administration >
Settings
>
User Management
>
Roles
Clone an already present role
The role with id
is cloned and the new id, name and description are
the ones provided in the request body.
Request:
Method:
POST
URI Path(s):
/policy/api/v1/aaa/roles/<role>?action=clone
Request Headers:
n/a
Query Parameters:
n/a
Request Body:
NewRole
+
NewRole
(
schema
)
Name
Description
Type
Notes
new_role_description
New role description
string
new_role_id
New role id
string
Required
Pattern: "^[_a-z0-9-]+$"
new_role_name
New role name
string
Required
Example Request:
POST https://<policy-mgr>/policy/api/v1/aaa/roles/myRole?action=clone { "new_role_id": "myNewRole", "new_role_name": "my new role", "new_role_description": "New role" }
Successful Response:
Response Code:
200 OK
Response Headers:
Content-type: application/json
Response Body:
NewRole
+
NewRole
(
schema
)
Name
Description
Type
Notes
new_role_description
New role description
string
new_role_id
New role id
string
Required
Pattern: "^[_a-z0-9-]+$"
new_role_name
New role name
string
Required
Example Response:
{ "new_role_id": "myNewRole", "new_role_name": "my new role", "new_role_description": "New role" }
Required Permissions:
crud
Feature:
users_custom_role
Additional Errors:
301 Moved Permanently
307 Temporary Redirect
400 Bad Request
403 Forbidden
409 Conflict
500 Internal Server Error
503 Service Unavailable