Update an existing role
- Zuletzt aktualisiert2020/04/15
Update an existing role
Use the Update Existing Role API to update an existing role in the Control Room.
Prerequisites
- Edit Roles
- Users who have
edit roles
permissions can update a role. - JSON Web Token (JWT)
- All Control Room APIs require a JSON Web Token (JWT) to access the APIs. Generate an authentication token using the Authentication API. See Enterprise 11 Authentication API.
- URL:
http://<your_control_room_url>/v1/usermanagement/roles/{ID}
.Replace the content in the angle brackets with your Control Room URL.
- Method: PUT.
- Use the Swagger definition files installed with your Control Room to test the APIs. View the available Swagger
APIs at:
http://<your_control_room_url>/swagger/
. - You can also use a REST client to complete this task.
Procedure
Note: You can also run REST requests from a command terminal. The following is a curl
request example. This example is formatted for readability. Replace the text inside
the angle brackets,
<authentication_token>
, with your
authentication token.curl -X PUT "http://<your_control_room_url>/v1/usermanagement/roles/37"
-H "accept: application/json"
-H "X-Authorization: <authentication_token>"
-H "Content-Type: application/json" -d "'{
"id": null,
"name": "viewRoles-Docs1",
"accessRestriction": null,
"permissions": [{
"id": 59,
"action": "ManageCredentials",
"resourceId": null,
"resourceType": "credentials"
}, {
"id": 134,
"action": "ViewUserBasic",
"resourceId": null,
"resourceType": "UserManagement"
}],
"countPrincipals": 0,
"principals": [{
"id": 21
}]
}'