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

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
  } ]
}