Files

Chen, Junjie f5b629cc78 DMS API 20240722 version

Reviewed-by: Ziuzko, Stanislav <stanislav.ziuzko@t-systems.com>
Co-authored-by: Chen, Junjie <chenjunjie@huawei.com>
Co-committed-by: Chen, Junjie <chenjunjie@huawei.com>

2024-09-06 09:17:23 +00:00

10 KiB

Raw Blame History

Querying a Message with a Specified Offset

Function

This API is used to query a message with a specified offset.

URI

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

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID. For details about how to obtain it, see Obtaining a Project ID.
instance_id	Yes	String	Instance ID.
topic	Yes	String	Topic name. A topic name must start with a letter and can only contain letters, hyphens (-), underscores (_), and digits.
partition	Yes	Integer	Partition number.

**Table 2** Query Parameters
Parameter	Mandatory	Type	Description
message_offset	Yes	String	Message offset.

Request Parameters

None

Response Parameters

Status code: 200

**Table 3** Response body parameters
Parameter	Type	Description
message	Array of ShowPartitionMessageEntity objects	Message list.

**Table 4** ShowPartitionMessageEntity
Parameter	Type	Description
key	String	Message key.
value	String	Message content.
topic	String	Topic name.
partition	Integer	Partition number.
message_offset	Long	Message offset.
size	Integer	Message size in bytes.
timestamp	Long	Time when a message is created. The value is a Unix timestamp. The unit is millisecond.

Example Requests

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

Example Responses

Status code: 200

The message with the specified offset is queried successfully.

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

Status Codes

Status Code	Description
200	The message with the specified offset is queried successfully.

Error Codes

See Error Codes.

Parent topic: Message Query

10 KiB Raw Blame History