Managed Service for Apache Kafka® API, REST: User.List
Retrieves the list of Kafka users in the specified cluster.
HTTP request
GET https://mdb.api.cloud.yandex.net/managed-kafka/v1/clusters/{clusterId}/users
Path parameters
|
Field |
Description |
|
clusterId |
string Required field. ID of the Apache Kafka® cluster to list Kafka users in. To get the Apache Kafka® cluster ID, make a ClusterService.List request. |
Query parameters
|
Field |
Description |
|
pageSize |
string (int64) The maximum number of results per page to return. If the number of available results is larger than |
|
pageToken |
string Page token. To get the next page of results, set |
Response
HTTP Code: 200 - OK
{
"users": [
{
"name": "string",
"clusterId": "string",
"permissions": [
{
"topicName": "string",
"role": "string",
"allowHosts": [
"string"
]
}
]
}
],
"nextPageToken": "string"
}
|
Field |
Description |
|
users[] |
List of Kafka users. |
|
nextPageToken |
string This token allows you to get the next page of results for list requests. If the number of results is larger than ListUsersRequest.pageSize, use the |
User
A Kafka user.
For more information, see the Operations -> Accounts section of the documentation.
|
Field |
Description |
|
name |
string Name of the Kafka user. |
|
clusterId |
string ID of the Apache Kafka® cluster the user belongs to. To get the Apache Kafka® cluster ID, make a ClusterService.List request. |
|
permissions[] |
Set of permissions granted to this user. |
Permission
|
Field |
Description |
|
topicName |
string Name or prefix-pattern with wildcard for the topic that the permission grants access to. To get the topic name, make a TopicService.List request. |
|
role |
enum (AccessRole) Access role type to grant to the user.
|
|
allowHosts[] |
string Lists hosts allowed for this permission. Bare in mind that the same host might appear in multiple permissions at the same time, |