Authorization Manager Update Authorization Role
Updates a role's name or privileges.
If the new set of privileges are assigned to the role, the system-defined privileges, "System.Anonymous", "System.View", and "System.Read" will be assigned to the role too. This operation might return before the new privileges are effective. A timeout of 100 ms is possible, but it might vary depending on the configuration and the load of the system.
Required privileges: Authorization.ModifyRoles
The unique identifier for the managed object to which the method attaches; the serialized managed object reference for a request has the form moType/moId
, in this case AuthorizationManager/{moId}
.
The vSphere release schema. The current specification covers vSphere 8.0.2.0 APIs.
{
"roleId": 0,
"newName": "string",
"privIds": [
"string"
]
}
The ID of the role that is updated.
The new name for the role.
The new set of privileges to assign to the role.
No Content
NotFound: if the role does not exist, or if a privilege in the list cannot be found.
InvalidArgument: if the role is a system role, meaning it cannot be changed.
InvalidName: if the new role name is empty.
AlreadyExists: if another role with the given name already exists.
NoPermission: if current session does not have any privilege that being updated in the new role or "Authorization.ModifyRoles" privilege on the root folder.
{
"_typeName": "string",
"faultCause": "MethodFault Object",
"faultMessage": [
{
"_typeName": "string",
"key": "string",
"arg": [
{
"_typeName": "string",
"key": "string",
"value": {
"_typeName": "string"
}
}
],
"message": "string"
}
]
}