Add Role to User

Overview

This operation assigns one or more existing roles to one or more users.

ACL Authorization Flow

The user making this request must be assigned with admin or spatial-admin roles.

HTTP PUT URL Format

The following format is used for HTTP PUT request:

PUT DATA:

{
"users": ["user1", "user2"],
"roles": ["role1", "role2"]
}

PUT HEADER: Content-Type:application/json

Parameters


Parameter	Type	Required	Description
users	String	Yes	Specifies a list of users.
roles	String	Yes	Specifies a list of roles.

Returns

Assigns specified role(s) to specified user(s).

Example for PUT

The following request assigns “spatial-user” and “spatial-sub-admin” roles to both “user1” and “user2”

Request URL

http://<server>:<port>/rest/Spatial/AccessControlService/roles/users

Request Body

{
    "users": ["user1", "user2"],
    "roles": ["spatial-user", "spatial-sub-admin"]
}

Response

200 OK

Note: It returns only 200 OK if the role(s) was assigned to the user(s). The newly added role gets added to the roles the user already may have. Only existing roles and users must be provided in the request.