Function

This API is used to query the user list.

User management is supported only when SASL is enabled for the Kafka instance.

URI

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

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID. For details about how to obtain it, see Obtaining a Project ID.
instance_id	Yes	String	Instance ID.

Request Parameters

None

Response Parameters

Status code: 200

**Table 2** Response body parameters
Parameter	Type	Description
users	Array of ShowInstanceUsersEntity objects	User list.

**Table 3** ShowInstanceUsersEntity
Parameter	Type	Description
user_name	String	Username. A username must start with a letter. It can contain 4 to 64 characters. Only letters, digits, underscores (_), and hyphens (-) are allowed.
user_desc	String	User description.
role	String	User role.
default_app	Boolean	Whether an application is the default application.
created_time	Long	Creation time.

Example Requests

Querying the user list.

GET https://{endpoint}/v2/{project_id}/instances/{instance_id}/users

Example Responses

Status code: 200

The query is successful.

{
  "users" : [ {
    "user_name" : "xxxa",
    "role" : "guest",
    "default_app" : false,
    "created_time" : 1615431764734
  }, {
    "user_name" : "test",
    "role" : "guest",
    "default_app" : false,
    "created_time" : 1615364062463
  }, {
    "user_name" : "ROOT",
    "role" : "guest",
    "default_app" : false,
    "created_time" : 1617194246328
  } ]
}

Status Codes

Status Code	Description
200	The query is successful.

Error Codes

See Error Codes.

Querying the User List