Creating a User

Function

This API is used to create a user.

URI

POST /v2/{project_id}/instances/{instance_id}/users

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID.
instance_id	Yes	String	Instance ID.

Request Parameters

**Table 2** Request body parameters
Parameter	Mandatory	Type	Description
access_key	No	String	Username.
secret_key	No	String	Secret key.
white_remote_address	No	String	IP address whitelist.
admin	No	Boolean	Whether the user is an administrator.
default_topic_perm	No	String	Default topic permissions.
default_group_perm	No	String	Default consumer group permissions.
topic_perms	No	Array of topic_perms objects	Special topic permissions.
group_perms	No	Array of group_perms objects	Special consumer group permissions.

**Table 3** topic_perms
Parameter	Mandatory	Type	Description
name	No	String	Topic name.
perm	No	String	Permissions.

**Table 4** group_perms
Parameter	Mandatory	Type	Description
name	No	String	Consumer group name.
perm	No	String	Permissions.

Response Parameters

Status code: 200

**Table 5** Response body parameters
Parameter	Type	Description
access_key	String	Username.
secret_key	String	Secret key.
white_remote_address	String	IP address whitelist.
admin	Boolean	Whether the user is an administrator.
default_topic_perm	String	Default topic permissions.
default_group_perm	String	Default consumer group permissions.
topic_perms	Array of topic_perms objects	Special topic permissions.
group_perms	Array of group_perms objects	Special consumer group permissions.

**Table 6** topic_perms
Parameter	Type	Description
name	String	Topic name.
perm	String	Permissions.

**Table 7** group_perms
Parameter	Type	Description
name	String	Consumer group name.
perm	String	Permissions.

Example Requests

{
  "access_key" : "user_name",
  "secret_key" : "O6bE3KjttD6Nc6ZtZP3axKLUHtOUaMnL",
  "white_remote_address" : "",
  "admin" : false,
  "default_topic_perm" : "DENY",
  "default_group_perm" : "DENY",
  "topic_perms" : [ {
    "name" : "topic1",
    "perm" : "PUB|SUB"
  } ],
  "group_perms" : [ {
    "name" : "group1",
    "perm" : "PUB|SUB"
  } ]
}

Example Responses

Status code: 200

The creation is successful.

{
  "users" : {
    "access_key" : "test_01",
    "admin" : false,
    "default_group_perm" : "DENY",
    "default_topic_perm" : "SUB",
    "group_perms" : [ ],
    "secret_key" : "x1234567@",
    "topic_perms" : [ ],
    "white_remote_address" : ""
  },
  "total" : 1
}