Creates a role.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request headers

This operation uses only common request headers. For more information, see the topic about common request parameters.

Request syntax

POST /pop/v5/account/create_role HTTP/1.1

Request parameters

Parameter Type Position Required Example Description
ActionData String Query Yes 15:1;14:2

The set of permissions to be granted to the role. The value is in the format of Permission group ID 1:Permission serial number 1;...;Permission group ID n:Permission serial number n. Example: 1:1;1:2;2:1;2:2. For more information about permission groups and permission serial numbers, see ListAuthority.

RoleName String Query Yes testrole

The name of the role.

Response parameters

Parameter Type Example Description
Code Integer 200

The HTTP status code.
Message String success

The returned message that indicates whether the call is successful.
RequestId String 57609587-DFA2-41EC-****-*********

The ID of the request.
RoleId Integer 33

The ID of the role.

Examples

Sample requests

POST /pop/v5/account/create_role HTTP/1.1
Common request headers
{
  "ActionData": ""
  "RoleName": ""
}

Sample success responses

XML format 

<RequestId>57609587-DFA2-41EC-****-*********</RequestId>
<Code>200</Code>
<Message>sucess</Message>

JSON format 

{
	"RequestId": "57609587-DFA2-41EC-****-*********",
	"Code": "200",
	"Message": "sucess"
}

Error codes

For a list of error codes, visit the API Error Center.