NSX-T Data Center REST API

Update custom role

Creates a new role with id as <role> if there does not exist any
role with id <role>, else updates the existing role. Permissions
for features marked is_internal as true will be ignored if provided in
request payload. These features' permission are set internally.

Request:

Method:
PUT
URI Path(s):
/policy/api/v1/aaa/roles/{role}
/api/v1/aaa/roles/{role}
Request Headers:
n/a
Query Parameters:
n/a
Request Body:
RoleWithFeatures+

Example Request:

PUT https://<nsx-mgr>/api/v1/aaa/roles/myRole { "role": "myRole", "features": [ { "feature": "policy_grouping", "permission": "read" }, { "feature": "vm_vm_info", "permission": "read" }, { "feature": "policy_services", "permission": "read" } ] }

Successful Response:

Response Code:
200 OK
Response Headers:
Content-type: application/json
Response Body:
RoleWithFeatures+

Example Response:

{ "role": "myRole", "features": [ { "feature": "policy_grouping", "permission": "read" }, { "feature": "vm_vm_info", "permission": "read" }, { "feature": "policy_services", "permission": "read" } ] }

Required Permissions:

crud

Feature:

users_custom_role

Additional Errors: