HP OneView REST API Reference

users
users.html[10/17/2013 10:35:59 AM]
}
URI: /rest/users/{userName}/roles
Method API
POST Adds a given set of roles to an existing user.
Request
Header
Attributes Description
REST API Request Headers NOTE: The X-API-Version header is required for all APIs. For the
current release, this must be set to "X-API-Version:3"
Request
Body
Attributes Description
RoleNameV2 Required Array of role(s) to be assigned
Response Description
RoleNameV2 Updated set of roles associated with the user
Response Codes
REST API Response Codes
Examples
POST https://{appl}/rest/users/{userName}/roles?multiResource=true
Example :
Adds multiple roles to an existing user
https://{app1}/rest/users/testUser1/roles?multiResource=true
[{
"type" : "RoleNameDtoV2",
"roleName" : "Infrastructure administrator"
},
{
"type" : "RoleNameDtoV2",
"roleName" : "<another role that may co-exist>"
}]
PUT Changes the current roles of a user with a given set of roles. Role names are case sensitive.
Modification to roles of built-in administrator is not allowed.
Request
Header
Attributes Description
REST API Request Headers NOTE: The X-API-Version header is required for all APIs. For the
current release, this must be set to "X-API-Version:3"
Request
Body
Attributes Description
RoleNameV2 Required Details containing the roles to be replaced
Response Description
RoleNameV2 Array of current roles of the user
Response Codes