Querying the Topic Consumer Group List
Function
This API is used to query the topic consumer group list.
URI
GET /v2/{project_id}/instances/{instance_id}/topics/{topic}/groups
| Parameter | Mandatory | Type | Description |
|---|---|---|---|
| project_id | Yes | String | Definition Project ID. For details about how to obtain it, see Obtaining a Project ID. Constraints N/A Range N/A Default Value N/A |
| instance_id | Yes | String | Definition Instance ID. You can call the API for querying all instances to obtain the instance ID. The instance ID is in the response body. Constraints N/A Range N/A Default Value N/A |
| topic | Yes | String | Definition Topic name. Constraints N/A Range N/A Default Value N/A |
| Parameter | Mandatory | Type | Description |
|---|---|---|---|
| limit | No | Integer | Definition Number of returned consumer groups of a query. Constraints N/A Range 1–50 Default Value 10 |
| offset | No | Integer | Definition Offset where the query starts. Constraints N/A Range ≥ 0 Default Value 0 |
Request Parameters
None
Response Parameters
Status code: 200
| Parameter | Type | Description |
|---|---|---|
| groups | Array of strings | Definition Consumer group list. Constraints N/A Range N/A Default Value N/A |
| total | Integer | Definition Total number of topics. Constraints N/A Range N/A Default Value N/A |
Example Requests
Querying the consumer group list of a specified topic
GET https://{endpoint}/v2/{project_id}/instances/{instance_id}/topics/{topic}/groups Example Responses
Status code: 200
Topic consumer group list queried successfully.
{
"total" : 2,
"groups" : [ "CID_JODIE_1", "test_consumer" ]
} Status Codes
| Status Code | Description |
|---|---|
| 200 | Topic consumer group list queried successfully. |
Error Codes
See Error Codes.
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.
For any further questions, feel free to contact us through the chatbot.
Chatbot