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.

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": "groups_ip_sets", "permission": "read" }, { "feature": "groups_mac_sets", "permission": "read" }, { "feature": "groups_ip_pools", "permission": "read" }, { "feature": "groups", "permission": "read" }, { "feature": "services", "permission": "read" } ] }

Successful Response:

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

Example Response:

{ "role": "myRole", "features": [ { "feature": "groups_ip_sets", "permission": "read" }, { "feature": "groups_mac_sets", "permission": "read" }, { "feature": "groups_ip_pools", "permission": "read" }, { "feature": "groups", "permission": "read" }, { "feature": "services", "permission": "read" } ] }

Required Permissions:

crud

Feature:

users_custom_role

Additional Errors: