You need to enable JavaScript to run this app.
Torch Log Service

Torch Log Service

Copy page
Download PDF
Kafka protocol consumption API
DescribeKafkaConsumer
Copy page
Download PDF
DescribeKafkaConsumer
  1. Call DescribeKafkaConsumer to view the Kafka consumption feature status for the specified log topic.​
Usage notes​
The call frequency of this interface is limited to 20 times/s, and an error ExceedQPSLimit will be reported if the frequency limit is exceeded.​
Request syntax​
  • Request Method:GET​
  • Request URL:https://{tls-endpoint}/DescribeKafkaConsumer​
Request parameters​
Query​
​
Name​
Type​
Required​
Example​
Description​
TopicId​
String​
True​
c7e0e442-19bf-4fb3-b547-5992fb8b****​
Topic ID.​
​
Responses​
​
Name​
Type​
Example​
Description​
AllowConsume​
Boolean​
true​
Specifies whether the log topic has Kafka protocol consumption enabled.​
  • true: turned on.​
  • false: not turned on.​
ConsumeTopic​
String​
out-0fdaa6b6-3c9f-424c-8664-fc0d222c****​
The Kafka protocol consumes topic ID in the format of out + log topic ID. Topic should specify this ID when consuming log data in this log topic through the Kafka protocol.​
​
Sample Request​
​
GET https://{tls-endpoint}/DescribeKafkaConsumer?TopicId=fa******** HTTP/1.1​
​
Sample Response​
​
HTTP/1.1 200 OK​
Content-Type: application/json; charset=utf-8 ​
{​
"AllowConsume": true,​
"ConsumeTopic": "out-fa************"​
}​
​
Error code​
For more information, see Common error codes.​
​
HTTP status code​
Error code​
Error message​
Description​
400​
InvalidArgument​
Invalid argument key %s, value %s, please check argument.​
Parameter is invalid.​
404​
TopicNotExist​
topic %s does not exist.​
The journal topic does not exist.​
500​
InternalServerError​
We encountered an unexpected server error, please try again later.​
Internal server error.​
​
​
​
Last updated: 2025.10.28 18:42:00