调用 DescribeUsers 接口获取 Kafka SASL 用户列表。
此接口用于查询指定 Kafka 实例下的用户列表,其中包括 Plain 用户和 Scram 用户。
下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。
参数 | 类型 | 是否必填 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DescribeUsers | 要执行的操作,取值:DescribeUsers。 |
Version | String | 是 | 2022-05-01 | API的版本,取值:2022-05-01。 |
InstanceId | String | 是 | kafka-cnngbnntswg1**** | 实例 ID。 |
PageNumber | Integer | 是 | 1 | 列表的页码,最小值为 1。 |
PageSize | Integer | 是 | 10 | 列表中每一页的条目数量,取值范围为 1~100。 |
UserName | String | 否 | Name | 根据用户名称进行筛选。支持模糊匹配。 |
下表仅列出本接口特有的返回参数。更多信息请参见返回结构。
参数 | 类型 | 示例值 | 描述 |
---|---|---|---|
Total | Integer | 2 | SASL 用户总数。 |
UsersInfo | Array of Object | -- | SASL 用户详情。 |
POST /?Action=DescribeUsers&Version=2022-05-01 HTTP/1.1 Content-Type: application/json Host: kafka.volcengineapi.com X-Date: 20210328T100802Z Authorization: HMAC-SHA256 Credential=AK********/20210328/cn-beijing/Kafka/request, SignedHeaders=x-date, Signature=******** { "InstanceId": "kafka-cnng1si21igu****", "PageNumber": 1, "PageSize": 2, "UserName": "test" }
{ "ResponseMetadata": { "RequestId": "20230227210916F1649DF74C41E16CB1CA", "Action": "DescribeUsers", "Version": "2022-05-01", "Service": "Kafka", "Region": "cn-beijing" }, "Result": { "Total": 2, "UsersInfo": [ { "AllAuthority": true, "CreateTime": "2022-07-18T07:48:58Z", "Description": "", "PasswordType": "Plain", "UserName": "test" }, { "AllAuthority": true, "CreateTime": "2022-07-18T07:48:58Z", "Description": "test-PHP-sdk", "PasswordType": "Scram", "UserName": "test-php-sdk" } ] } }
下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。
状态码 | 错误码 | 说明 |
---|---|---|
400 | InvalidParameter | 参数值无效。 |
403 | OperationDenied.AccountNotAuthorized | 您不具备相关权限 ,请授权或切换账号后重试。 |
404 | InvalidUserName.NotFound | SASL用户不存在。 |
404 | InvalidInstanceId.NotFound | 实例不存在。 |
500 | InternalError | 内部错误,请稍后重试。 |