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 instancias> Consulta del estado de uso del disco de los temas

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

Ver PDF

Consulta del estado de uso del disco de los temas

Función

Esta API se utiliza para consultar el uso del disco del agente de temas.

URI

GET /v2/{project_id}/instances/{instance_id}/topics/diskusage

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

**Tabla 2** Parámetros de consulta
Parámetro	Obligatorio	Tipo	Descripción
minSize	No	String	Consulta de particiones por el espacio de disco utilizado. Opciones: 1 KB, 1 MB y 1 GB. Valor predeterminado: 1 GB.
top	No	String	Consulta de particiones por uso de disco superior.
percentage	No	String	Consulta de particiones por el porcentaje del espacio en disco utilizado.

Parámetros de solicitud

Ninguno

Parámetros de respuesta

Código de estado: 200

**Tabla 3** Parámetros del cuerpo de respuesta
Parámetro	Tipo	Descripción
broker_list	Matriz de objectos DiskusageEntity	Lista de agentes.

**Tabla 4** DiskusageEntity
Parámetro	Type	Descripción
broker_name	String	Nombre del agente.
data_disk_size	String	Capacidad del disco.
data_disk_use	String	Espacio en disco usado.
data_disk_use	String	Espacio en disco restante.
data_disk_use_percentage	String	Etiqueta de mensaje.
status	String	Etiqueta de mensaje.
topic_list	Matriz de objetos DiskusageTopicEntity	Lista de los temas de uso del disco.

**Tabla 5** DiskusageTopicEntity
Parámetro	Tipo	Descripción
size	String	Uso del disco.
topic_name	String	Nombre del tema.
topic_partition	String	Partición.
percentage	Doble	Porcentaje de espacio en disco usado.

Solicitudes de ejemplo

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

Respuestas de ejemplo

Código de estado: 200

La consulta se realiza correctamente.

{
  "broker_list" : [ {
    "broker_name" : "broker-0",
    "data_disk_size" : "66G",
    "data_disk_use" : "53M",
    "data_disk_free" : "63G",
    "data_disk_use_percentage" : "1",
    "status" : "Success get info",
    "topic_list" : [ {
      "size" : "12K",
      "topic_name" : "topic-test",
      "topic_partition" : "2",
      "percentage" : 1.7339533025568183E-5
    }, {
      "size" : "12K",
      "topic_name" : "__consumer_offsets",
      "topic_partition" : "4",
      "percentage" : 1.7339533025568183E-5
    }, {
      "size" : "12K",
      "topic_name" : "__consumer_offsets",
      "topic_partition" : "3",
      "percentage" : 1.7339533025568183E-5
    }, {
      "size" : "8.0K",
      "topic_name" : "__trace",
      "topic_partition" : "6",
      "percentage" : 1.1559688683712121E-5
    }, {
      "size" : "8.0K",
      "topic_name" : "__trace",
      "topic_partition" : "4",
      "percentage" : 1.1559688683712121E-5
    }, {
      "size" : "8.0K",
      "topic_name" : "__trace",
      "topic_partition" : "2",
      "percentage" : 1.1559688683712121E-5
    }, {
      "size" : "8.0K",
      "topic_name" : "__trace",
      "topic_partition" : "0",
      "percentage" : 1.1559688683712121E-5
    }, {
      "size" : "8.0K",
      "topic_name" : "topic-test",
      "topic_partition" : "0",
      "percentage" : 1.1559688683712121E-5
    }, {
      "size" : "8.0K",
      "topic_name" : "topic-1568537362",
      "topic_partition" : "2",
      "percentage" : 1.1559688683712121E-5
    }, {
      "size" : "8.0K",
      "topic_name" : "__consumer_offsets",
      "topic_partition" : "7",
      "percentage" : 1.1559688683712121E-5
    } ]
  } ]
}