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)> Gestión de temas> Consulta de los detalles del tema

Actualización más reciente 2022-11-07 GMT+08:00

Ver PDF

Consulta de los detalles del tema

Función

Esta API se utiliza para consultar los detalles del tema de una instancia de Kafka.

URI

GET /v2/{project_id}/instances/{instance_id}/management/topics/{topic}

**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

Parámetros de solicitud

No hay

Parámetros de respuesta

Código de estado: 200

**Tabla 2** Parámetros del cuerpo de respuesta
Parámetro	Tipo	Descripción
topic	String	Nombre del tema
partitions	Array of partitions objects	Lista de particiones.
group_subscribed	Array of strings	Lista de grupos de consumidores que se suscriben al tema.

**Tabla 3** partitions
Parámetro	Tipo	Descripción
partition	Integer	ID de partición
leader	Integer	ID del corredor donde reside la réplica de líder.
leo	Integer	LEO de la réplica de líder de partición.
hw	Integer	Marca de agua alta (HW) de la partición.
lso	Integer	Offset de inicio de registro (LSO) de la réplica de líder de partición.
last_update_timestamp	Long	Hora en que se escribió el último mensaje en la partición. El valor es una marca de tiempo de Unix. Unidad: ms
replicas	Array of replicas objects	Lista de réplicas.

**Tabla 4** replicas
Parámetro	Tipo	Descripción
broker	Integer	ID del corredor donde reside la réplica.
leader	Boolean	Si la réplica es el líder.
in_sync	Boolean	Si la réplica está en el ISR.
size	Integer	Tamaño actual del log de la réplica. Unidad: byte.
lag	Integer	Número de mensajes que se retrasan por detrás de la marca de agua alta en la réplica.

Ejemplo de las solicitudes

GET https://{endpoint}/v2/{project_id}/instances/{instance_id}/management/topics/{topic}

Ejemplo de las respuestas

Código de estado: 200

La consulta se realiza correctamente.

{
  "topic" : "test",
  "partitions" : [ {
    "partition" : 0,
    "leader" : 2,
    "replicas" : [ {
      "broker" : 2,
      "leader" : true,
      "in_sync" : true,
      "size" : 123971146,
      "lag" : 0
    }, {
      "broker" : 1,
      "leader" : false,
      "in_sync" : true,
      "size" : 123971146,
      "lag" : 0
    }, {
      "broker" : 0,
      "leader" : false,
      "in_sync" : true,
      "size" : 123971146,
      "lag" : 0
    } ],
    "lso" : 0,
    "leo" : 13598,
    "hw" : 13598,
    "last_update_timestamp" : 1571477180985
  }, {
    "partition" : 2,
    "leader" : 1,
    "replicas" : [ {
      "broker" : 1,
      "leader" : true,
      "in_sync" : true,
      "size" : 123889531,
      "lag" : 0
    }, {
      "broker" : 0,
      "leader" : false,
      "in_sync" : true,
      "size" : 123889531,
      "lag" : 0
    }, {
      "broker" : 2,
      "leader" : false,
      "in_sync" : true,
      "size" : 123889531,
      "lag" : 0
    } ],
    "lso" : 0,
    "leo" : 13601,
    "hw" : 13601,
    "last_update_timestamp" : 1571477077146
  }, {
    "partition" : 1,
    "leader" : 0,
    "replicas" : [ {
      "broker" : 0,
      "leader" : true,
      "in_sync" : true,
      "size" : 127245604,
      "lag" : 0
    }, {
      "broker" : 2,
      "leader" : false,
      "in_sync" : true,
      "size" : 127245604,
      "lag" : 0
    }, {
      "broker" : 1,
      "leader" : false,
      "in_sync" : true,
      "size" : 127245604,
      "lag" : 0
    } ],
    "lso" : 0,
    "leo" : 13599,
    "hw" : 13599,
    "last_update_timestamp" : 1571477172959
  } ],
  "group_subscribed" : [ "test-consumer-group" ]
}