更新时间:2023-08-16 GMT+08:00

查询分区指定偏移量的消息

功能介绍

查询分区指定偏移量的消息。

URI

GET /v2/{project_id}/instances/{instance_id}/management/topics/{topic}/partitions/{partition}/message

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID,获取方式请参见获取项目ID

instance_id

String

实例ID。

topic

String

Topic名称。

Topic名称必现以字母开头且只支持大小写字母、中横线、下划线以及数字。

partition

Integer

分区编号。

表2 Query参数

参数

是否必选

参数类型

描述

message_offset

String

消息位置。

请求参数

响应参数

状态码: 200

表3 响应Body参数

参数

参数类型

描述

message

Array of ShowPartitionMessageEntity objects

消息列表。

表4 ShowPartitionMessageEntity

参数

参数类型

描述

key

String

消息的key。

value

String

消息内容。

topic

String

Topic名称。

partition

Integer

分区编号。

message_offset

Long

消息位置。

size

Integer

消息大小,单位字节。

timestamp

Long

生产消息的时间。 格式为Unix时间戳。单位为毫秒。

请求示例

GET https://{endpoint}/v2/{project_id}/instances/{instance_id}/management/topics/{topic}/partitions/{partition}/message?message_offset={message_offset}

响应示例

状态码: 200

查询分区指定偏移量的消息成功。

{
  "message" : [ {
    "topic" : "mytest",
    "partition" : 0,
    "message_offset" : 7,
    "key" : null,
    "value" : "kasjdf",
    "size" : 6,
    "timestamp" : 1568125036045
  } ]
}

状态码

状态码

描述

200

查询分区指定偏移量的消息成功。

错误码

请参见错误码