查询消费者组成员列表
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求语法
GET /v1/consumer-groups/{consumerGroupId}/consumers HTTP/1.1
路径参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| consumerGroupId |
string |
否 |
消费者组 ID。 |
csg-8c13d2b4f8a1 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| nameLike |
string |
否 |
按消费者名称模糊过滤。 |
consumer |
| pageNumber |
integer |
否 |
页码。 |
1 |
| pageSize |
integer |
否 |
每页数量。 |
10 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
Schema of Response |
||
| requestId |
string |
Id of the request |
473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E |
| code |
string |
响应状态码。请求成功时返回 Ok。 |
Ok |
| message |
string |
响应消息。 |
success |
| data |
object |
响应数据。 |
|
| totalSize |
integer |
符合条件的消费者总数。 |
2 |
| pageNumber |
integer |
当前页码。 |
1 |
| pageSize |
integer |
每页数量。 |
10 |
| items |
array<object> |
消费者组成员列表。 |
|
|
object |
消费者组成员列表项。 |
||
| consumerId |
string |
消费者 ID。 |
cs-8c13d2b4f8a1 |
| name |
string |
消费者名称。 |
api-consumer |
| description |
string |
消费者描述。 |
线上 API 调用方 |
| enable |
boolean |
消费者是否启用。 |
true |
| deployStatus |
string |
消费者部署状态。代码定义的取值为 Processing、Failed 和 Success。 枚举值:
|
Success |
| joinTimestamp |
integer |
加入消费者组的时间,Unix 毫秒时间戳。 |
1715769600000 |
示例
正常返回示例
JSON格式
{
"requestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
"code": "Ok",
"message": "success",
"data": {
"totalSize": 2,
"pageNumber": 1,
"pageSize": 10,
"items": [
{
"consumerId": "cs-8c13d2b4f8a1",
"name": "api-consumer",
"description": "线上 API 调用方",
"enable": true,
"deployStatus": "Success",
"joinTimestamp": 1715769600000
}
]
}
}
错误码
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。