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.
Actualización más reciente 2022-12-29 GMT+08:00

Consulta de estado de ECS

Función

Esta API se utiliza para consultar el estado de ECS.

URI

GET /hss/v1/{project_id}/api/host-management/hosts

Tabla 1 Parámetros de URI

Parámetro

Obligatorio

Tipo

Descripción

project_id

String

ID del proyecto.

Tabla 2 Parámetros de Query

Parámetro

Obligatorio

Tipo

Descripción

version

No

String

Edición HSS. Sus valores y su significado son los siguientes:

  • hss.version.null: ninguna
  • hss.version.basic: edición básica
  • hss.version.enterprise: edición empresarial
  • hss.version.premium: edición premium
  • hss.version.wtp: edición WTP

agent_status

No

String

Estado de agente. Su valor puede ser:

  • not_register
  • online
  • offline

host_status

No

String

Estado de agente. Su valor puede ser:

  • ACTIVE
  • SHUTOFF
  • BUILDING
  • ERROR

protect_status

No

String

Estado de protección. Su valor puede ser:

  • closed
  • opened

detect_result

No

String

Estado de protección. Su valor puede ser:

  • undetect (no escaneado)
  • clean (sin riesgo)
  • risk (riesgo detectado)

host_name

No

String

Nombre del servidor

host_ip

No

String

Dirección IP privada del servidor

public_ip

No

String

EIP del servidor

os_type

No

String

Tipo de sistema operativo

charging_mode

No

String

Modo de facturación. Puede ser:

  • packet_cycle (paquete mensual/anual)
  • on_demand (pago por uso)

limit

No

Integer

Valor predeterminado: 10

offset

No

Integer

Valor predeterminado: 0

Parámetro de solicitud

Tabla 3 Parámetro de header de solicitud

Parámetro

Obligatorio

Tipo

Descripción

x-auth-token

String

Token de usuario. Se puede obtener llamando a la API IAM (valor de X-Subject-Token en el encabezado de respuesta).

Parámetros de respuesta

Código de estado: 200

Tabla 4 Parámetros de body de respuesta

Parámetro

Tipo

Descripción

total_num

Integer

Cantidad total

data_list

Array of objects

Consulta el estado de ECS.

Tabla 5 Host

Parámetro

Tipo

Descripción

agent_id

String

id de agente

host_id

String

ID del servidor

host_name

String

Nombre del servidor

host_ip

String

Dirección IP privada del servidor

public_ip

String

EIP del servidor

enterprise_project_name

String

Nombre del proyecto de empresa

group_name

String

Nombre del grupo de servidores

expire_time

Long

Tiempo de caducidad del servicio

policy_group_name

String

Nombre del grupo de políticas

host_status

String

Estado de agente. Su valor puede ser:

  • ACTIVE
  • SHUTOFF
  • BUILDING
  • ERROR

agent_status

String

Estado de agente. Su valor puede ser:

  • uninstall
  • online
  • offline

version

String

Edición HSS. Sus valores y su significado son los siguientes:

  • hss.version.null: ninguna
  • hss.version.basic: edición básica
  • hss.version.enterprise: edición empresarial
  • hss.version.premium: edición premium
  • hss.version.wtp: edición WTP

protect_status

String

Estado de protección. Su valor puede ser:

  • closed
  • opened

os_image

String

Imagen del sistema

os_type

String

Tipo de sistema operativo

os_bit

String

Versión del bit del sistema operativo

detect_result

String

Resultado del análisis del servidor. Su valor puede ser:

  • undetect (no escaneado)
  • clean (sin riesgo)
  • risk (riesgo detectado)

risk_port_num

Integer

Número de riesgos de activos

risk_vul_num

Integer

Número de vulnerabilidades

risk_intrusion_num

Integer

Número de intrusiones

risk_baseline_num

Integer

Número de riesgos de línea de base

charging_mode

String

Modo de facturación. Puede ser:

  • packet_cycle (paquete mensual/anual)
  • on_demand (pago por uso)

resource_id

String

ID de instancia de recurso de servicio en la nube (UUID)

Ejemplo de solicitud

Ninguno.

Ejemplo de respuesta

Ninguno.

Código de estado

Código de estado

Descripción

200

Se ha obtenido la lista de servidores.

Código de error

Para obtener más información, consulte Códigos de error.