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> MapReduce Service> Referencia de la API> API V1.1> Las API de gestión de clústeres> Consulta de una lista de host

Actualización más reciente 2023-07-28 GMT+08:00

Ver PDF

Consulta de una lista de host

Función

Esta API se utiliza para consultar una lista de hosts de un clúster especificado.

Restricciones

Ninguna

Depuración

Puede depurar esta API a través de la autenticación automática en API Explorer. API Explorer puede generar automáticamente código SDK de ejemplo y proporcionar la depuración de código SDK de ejemplo.

URI

Formato
GET /v1.1/{project_id}/clusters/{cluster_id}/hosts

Descripción de parámetro

**Tabla 1** Parámetros de URI
Parámetro	Obligatorio	Tipo	Descripción
project_id	Sí	String	ID del proyecto. Para obtener más información sobre cómo obtener el ID del proyecto, consulte Obtención de un ID de proyecto.
cluster_id	Sí	String	ID de clúster. Para obtener más información acerca de cómo obtener el valor, consulte Obtención de la información del clúster MRS.

**Tabla 2** Parámetros de Query
Parámetro	Obligatorio	Tipo	Descripción
pageSize	No	Integer	Número máximo de clústeres mostrados en una página Rango de valores: [1-2147483646]. El valor predeterminado es 10.
currentPage	No	Integer	Número de página actual. El valor predeterminado es 1.

Parámetros de solicitud

Ninguna

Parámetros de respuesta

**Tabla 3** Parámetros de body de respuesta
Parámetro	Tipo	Descripción
total	Integer	Número total de hosts en una lista
hosts	Array of HostModel objects	Parámetros de host Para obtener más información, consulte Tabla 4.

**Tabla 4** HostModel
Parámetro	Tipo	Descripción
id	String	VM ID
ip	String	Dirección IP de VM
availability_zone_id	String	La zona de disponibilidad.
tags	Array of TagPlain objects	La lista de etiquetas. Para obtener más información, consulte Tabla 5.
flavor	String	ID de variante de VM
type	String	Tipo de VM Actualmente, MasterNode, CoreNode y TaskNode son compatibles.
name	String	Nombre de la VM
status	String	Estado actual de la VM
resource_id	String	ID de recurso de nodo
mem	String	Memoria
cpu	String	Número de núcleos de CPU
root_volume_size	String	Capacidad del disco del sistema operativo
data_volume_type	String	Tipo de disco de datos
data_volume_size	Integer	Capacidad del disco de datos
data_volume_count	Integer	Número de discos de datos

**Tabla 5** parámetros de TagPlain
Parámetro	Tipo	Descripción
key	String	La clave de etiqueta. Una clave de etiqueta no puede contener caracteres especiales (*=<>\,\|/**) ni empezar o terminar con espacios.
value	String	El valor. Un valor de etiqueta no puede contener caracteres especiales (*=<>\,\|/**) ni empezar o terminar con espacios.

Solicitud de ejemplo

GET /v1.1/{project_id}/clusters/{cluster_id}/hosts

Ejemplo de respuesta

Código de estado: 200

La consulta de la lista de hosts se realiza correctamente.

{
  "total" : "5",
  "hosts" : [ {
    "id" : "063d1d47-ae91-4a48-840c-b3cfe4efbcf0",
    "name" : "a78e161c-d14f-4b68-8c2d-0219920ce844_node_core_IQhiC",
    "ip" : "192.168.0.169",
    "availability_zone_id" : null,
    "tags" : null,
    "status" : "ACTIVE",
    "resource_id" : "95c1eabc-ed1d-4037-97d1-62f0587790c7",
    "flavor" : "c2.2xlarge.linux.mrs",
    "type" : "Core",
    "mem" : "16384",
    "cpu" : "8",
    "root_volume_size" : "480",
    "data_volume_type" : "SATA",
    "data_volume_size" : "600",
    "data_volume_count" : "1"
  }, {
    "id" : "dc5c6208-faa2-4727-a65a-2b1ce235d350",
    "name" : "a78e161c-d14f-4b68-8c2d-0219920ce844_node_master1_ASzkl",
    "ip" : "192.168.0.156",
    "availability_zone_id" : null,
    "tags" : null,
    "status" : "ACTIVE",
    "resource_id" : "95c1eabc-ed1d-4037-97d1-62f0587790c7",
    "flavor" : "c2.4xlarge.linux.mrs",
    "type" : "Master",
    "mem" : "32768",
    "cpu" : "16",
    "root_volume_size" : "480",
    "data_volume_type" : "SATA",
    "data_volume_size" : "600",
    "data_volume_count" : "1"
  }, {
    "id" : "c0ce793d-848b-448a-835b-ea0cac534b09",
    "name" : "a78e161c-d14f-4b68-8c2d-0219920ce844_node_core_ANnRN",
    "ip" : "192.168.0.243",
    "availability_zone_id" : null,
    "tags" : null,
    "status" : "ACTIVE",
    "resource_id" : "95c1eabc-ed1d-4037-97d1-62f0587790c7",
    "flavor" : "c2.2xlarge.linux.mrs",
    "type" : "Core",
    "mem" : "16384",
    "cpu" : "8",
    "root_volume_size" : "480",
    "data_volume_type" : "SATA",
    "data_volume_size" : "600",
    "data_volume_count" : "1"
  }, {
    "id" : "95c23e43-ef6e-4732-b6ed-a5f1c7779fae",
    "name" : "a78e161c-d14f-4b68-8c2d-0219920ce844_node_core_uRRiA",
    "ip" : "192.168.0.126",
    "availability_zone_id" : null,
    "tags" : null,
    "status" : "ACTIVE",
    "resource_id" : "95c1eabc-ed1d-4037-97d1-62f0587790c7",
    "flavor" : "c2.2xlarge.linux.mrs",
    "type" : "Core",
    "mem" : "16384",
    "cpu" : "8",
    "root_volume_size" : "480",
    "data_volume_type" : "SATA",
    "data_volume_size" : "600",
    "data_volume_count" : "1"
  }, {
    "id" : "63bdbf75-1133-4a94-8c27-1fa12c8b9e70",
    "name" : "a78e161c-d14f-4b68-8c2d-0219920ce844_node_master2_StqFu",
    "ip" : "192.168.0.22",
    "availability_zone_id" : null,
    "tags" : null,
    "status" : "ACTIVE",
    "resource_id" : "95c1eabc-ed1d-4037-97d1-62f0587790c7",
    "flavor" : "c2.4xlarge.linux.mrs",
    "type" : "Master",
    "mem" : "32768",
    "cpu" : "16",
    "root_volume_size" : "480",
    "data_volume_type" : "SATA",
    "data_volume_size" : "600",
    "data_volume_count" : "1"
  } ]
}