Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.
Centro de ayuda/ Distributed Message Service for Kafka/ Referencia de la API/ APIs V2 (Recomendado)/ Consulta de mensaje/ Consulta de un mensaje con un offset especificado
Actualización más reciente 2022-11-07 GMT+08:00
Ver PDF
Compartir

Consulta de un mensaje con un offset especificado

Función

Esta API se utiliza para consultar un mensaje con un offset especificado.

URI

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

Tabla 1 Parámetros de ruta

Parámetro

Obligatorio

Tipo

Descripción

project_id

Sí

String

ID del proyecto.

instance_id

Sí

String

ID de la instancia

topic

Sí

String

Nombre del tema

Un nombre de tema debe comenzar con una letra y solo puede contener letras, guiones (-), guiones bajos (_), y dígitos.

partition

Sí

Integer

Número de partición.
Tabla 2 Parámetros de consulta

Parámetro

Obligatorio

Tipo

Descripción

message_offset

Sí

String

Offset de mensaje.

Parámetros de solicitud

No hay

Parámetros de respuesta

Código de estado: 200

Tabla 3 Parámetros del cuerpo de respuesta

Parámetro

Tipo

Descripción

message

Array of ShowPartitionMessageEntity objects

Lista de mensajes.
Tabla 4 ShowPartitionMessageEntity

Parámetro

Tipo

Descripción

key

String

Clave de mensaje

value

String

Contenido del mensaje

topic

String

Nombre del tema

partition

Integer

Número de partición.

message_offset

Long

Offset de mensaje.

size

Integer

Tamaño del mensaje en bytes.

timestamp

Long

Hora en la que se crea un mensaje. El valor es una marca de tiempo de Unix. La unidad es milisegundo.

Ejemplo de las solicitudes

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

Ejemplo de las respuestas

Código de estado: 200

El mensaje con el offset especificado se consulta correctamente.

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

Códigos de estado

Código de estado

Descripción

200

El mensaje con el offset especificado se consulta correctamente.

Códigos de error

Consulte Códigos de error.

Tema principal: Consulta de mensaje