查询主题分区详情
所有文档
menu

消息服务 for Kafka

查询主题分区详情

产品详情立即开通

该接口用于查询指定集群的主题的指定分区信息。

请求结构

GET /v{version}/clusters/{clusterId}/topics/{topicName}/partitions/{partitionId}/statuses HTTP/1.1
Host: kafka-api.bj.baidubce.com
Authorization: authorization string

请求头域

除公共头域外,无其他特殊头域。

请求参数

参数名称 类型 是否必须 参数位置 描述
version String URL参数 API版本号
clusterId String URL参数 待查询的集群ID
topicName String URL参数 待查询的主题名称
partitionId String URL参数 待查询的分区ID

返回头域

除公共头域外,无其他特殊头域。

返回参数

参数名称 类型 描述
partition TopicPartition 主题分区信息,具体参见 TopicPartition

错误码

错误码 错误描述 HTTP状态码 中文解释
ERROR_PARAMS 请求参数错误 400 请求参数错误
CLUSTER_NOT_FOUND 集群不存在 451 集群不存在
CLUSTER_HAD_DELETED 集群已删除 451 集群已删除
CLUSTER_NOT_BELONGED 未拥有该集群 451 未拥有该集群
CLUSTER_NOT_AVAILABLE 集群不可用 451 集群不可用
TOPIC_NOT_EXIST 主题不存在 451 主题不存在
TOPIC_PARTITION_NOT_EXIST 分区不存在 451 分区不存在
INTERNAL_ERROR 服务内部错误 500 服务内部错误

请求示例

GET http://kafka-api.bj.baidubce.com/v2/clusters/33a168bb70c0459787416077114ab233/topics/demo-topic-test/partitions/1/statuses
Authorization: bce-auth-v1/ALTAKaiKeDfBD880eMWBE5oIGE/2023-05-08T11:43:45Z/1800/host;x-bce-date/322f3f98ce57d296c0f5abc64e5554b640ea035c5cb462fcaeab54b9810a3c61
Host: kafka-api.bj.baidubce.com

返回示例

HTTP/1.1 200 OK
x-bce-request-id: 97e6d4ad-6fca-4609-ad4d-9a27c4d1a362
Date: Mon, 08 May 2023 09:39:11 GMT
Content-Type: application/json;charset=UTF-8
Server: BWS

{
    "topicName": "test",
    "partition": {
            "topicName": "test",
            "partitionId": 1,
            "leaderId": 1027,
            "replicas": [1027,1011,1009],
            "inSyncReplicas": [1027,1011,1009],
            "minOffset": 0,
            "maxOffset": 1024,
            "messageNum": 1024,
            "lastUpdateTime": "2023-05-10T03:06:25Z"
         }
}
上一篇
查询主题分区列表
下一篇
查询主题订阅详情