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/ Host Security Service/ Referencia de la API/ Descripción de la API/ Gestión de host/ Consulta de ECS

Actualización más reciente 2022-12-29 GMT+08:00

Ver PDF

Consulta de ECS

Función

Esta API se utiliza para consultar ECS.

URI

GET /v5/{project_id}/host-management/hosts

**Tabla 1** Parámetros de path
Parámetro	Obligatorio	Tipo	Descripción
project_id	Sí	String	ID del proyecto del inquilino Mínimo: 1 Máximo: 256

**Tabla 2** Parámetros de Query
Parámetro	Obligatorio	Tipo	Descripción
enterprise_project_id	No	String	ID del proyecto empresarial Predeterminado: 0 Mínimo: 0 Máximo: 256
version	No	String	Edición HSS. Las opciones son las 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 hss.version.container.company: edición de contenedor Mínimo: 1 Máximo: 64
agent_status	No	String	Estado de agente. Las opciones son las siguientes: not_ installed online offline install_failed installing not_online: todo el estado excepto online, que se utiliza solo como una condición de consulta. Mínimo: 1 Máximo: 12
detect_result	No	String	Resultado de la detección. Las opciones son las siguientes: undetected clean risk scanning Mínimo: 1 Máximo: 32
host_name	No	String	Nombre del servidor Mínimo: 0 Máximo: 128
host_id	No	String	ID del servidor Mínimo: 0 Máximo: 128
host_status	No	String	Estado del host. Las opciones son las siguientes: ACTIVE SHUTOFF BUILDING ERROR Mínimo: 1 Máximo: 32
os_type	No	String	Tipo de sistema operativo. Las opciones son las siguientes: Linux Windows Mínimo: 0 Máximo: 64
private_ip	No	String	Dirección IP privada del servidor Mínimo: 0 Máximo: 128
public_ip	No	String	Dirección IP pública del servidor Mínimo: 0 Máximo: 128
ip_addr	No	String	Dirección IP pública o privada Mínimo: 0 Máximo: 128
protect_status	No	String	Estado de protección. Las opciones son las siguientes: closed opened Mínimo: 1 Máximo: 32
group_id	No	String	ID de grupo de servidores Mínimo: 0 Máximo: 128
group_name	No	String	Nombre del grupo de servidores Mínimo: 0 Máximo: 256
policy_group_id	No	String	ID de grupo de política Mínimo: 0 Máximo: 128
policy_group_name	No	String	Nombre del grupo de políticas Mínimo: 0 Máximo: 256
charging_mode	No	String	Modo de facturación. Las opciones son las siguientes: packet_cycle: yearly/monthly on_demand: pay-per-use Mínimo: 1 Máximo: 32
refresh	No	Boolean	Si se deben sincronizar a la fuerza los servidores de los ECS
above_version	No	Boolean	Si se devuelven todas las versiones posteriores a la versión actual
outside_host	No	Boolean	Si un servidor es un servidor Huawei Cloud
asset_value	No	String	Importancia de los activos. Las opciones son las siguientes: important common test Mínimo: 0 Máximo: 128
label	No	String	Etiqueta de activo Mínimo: 1 Máximo: 64
limit	No	Integer	Número de registros mostrados en cada página. El valor predeterminado es 10. Mínimo: 0 Máximo: 200 Predeterminado: 10
offset	No	Integer	Desfase, que especifica la posición inicial del registro que se va a devolver. El valor debe ser un número no menor que 0. El valor predeterminado es 0. Mínimo: 0 Máximo: 100000 Predeterminado: 0

Parámetros de solicitud

**Tabla 3** Parámetros de encabezado de solicitud
Parámetro	Obligatorio	Tipo	Descripción
x-auth-token	Sí	String	Token de usuario. Se puede obtener llamando a la API de IAM utilizada para obtener un token de usuario. El valor de X-Subject-Token en el encabezado de respuesta es un token. Mínimo: 1 Máximo: 32768
region	No	String	id de región Mínimo: 0 Máximo: 128

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	Número total de registros Mínimo: 0 Máximo: 2097152
data_list	Array of Host objects	Consulta sobre el estado y la lista del servidor en la nube

**Tabla 5** Host
Parámetro	Tipo	Descripción
host_name	String	Nombre del servidor Mínimo: 0 Máximo: 128
host_id	String	ID del servidor Mínimo: 0 Máximo: 128
agent_id	String	ID de agente Mínimo: 0 Máximo: 128
private_ip	String	Dirección IP privada Mínimo: 0 Máximo: 128
public_ip	String	Dirección IP elástica Mínimo: 0 Máximo: 128
enterprise_project_name	String	Nombre del proyecto de empresa Mínimo: 0 Máximo: 256
host_status	String	Estado del servidor. Las opciones son las siguientes: ACTIVE SHUTOFF BUILDING ERROR Mínimo: 1 Máximo: 32
agent_status	String	Estado de agente. Las opciones son las siguientes: not_ installed online offline install_failed installing Mínimo: 1 Máximo: 32
install_result_code	String	Resultado de la instalación. Las opciones son las siguientes: install_succeed network_access_timeout: Se ha agotado el tiempo de espera de la conexión. Error de red. invalid_port auth_failed: Error de autenticación debido a una contraseña incorrecta. permission_denied: Permisos insuficientes. no_available_vpc: No hay servidores con un agente en línea en la VPC actual. install_exception invalid_param install_failed package_unavailable os_type_not_support: Tipo de sistema operativo incorrecto os_arch_not_support: arquitectura de sistema operativo incorrecta Mínimo: 1 Máximo: 32
version	String	Edición HSS. Las opciones son las siguientes: hss.version.null: none 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 hss.version.container.company: edición de contenedor Mínimo: 1 Máximo: 32
protect_status	String	Estado de protección. Las opciones son las siguientes: closed opened Mínimo: 1 Máximo: 32
os_image	String	Imagen de disco del sistema Mínimo: 0 Máximo: 128
os_type	String	Tipo de sistema operativo. Las opciones son las siguientes: Linux Windows Mínimo: 0 Máximo: 128
os_bit	String	Versión del bit del sistema operativo Mínimo: 0 Máximo: 128
detect_result	String	Resultado del análisis del servidor. Las opciones son las siguientes: undetected clean risk scanning Mínimo: 1 Máximo: 32
charging_mode	String	Modo de facturación. Las opciones son las siguientes: packet_cycle: yearly/monthly on_demand: pay-per-use Mínimo: 1 Máximo: 32
resource_id	String	ID de instancia de recurso de servicio en la nube (UUID) Mínimo: 0 Máximo: 128
outside_host	Boolean	Si un servidor es un servidor que no es de Huawei Cloud
group_id	String	ID de grupo de servidores Mínimo: 1 Máximo: 128
group_name	String	Nombre del grupo de servidores Mínimo: 1 Máximo: 128
policy_group_id	String	ID de grupo de política Mínimo: 1 Máximo: 128
policy_group_name	String	Nombre del grupo de políticas Mínimo: 1 Máximo: 128
asset	Integer	Riesgo de activos Mínimo: 0 Máximo: 2097152
vulnerability	Integer	Vulnerabilidad Mínimo: 0 Máximo: 2097152
baseline	Integer	Riesgos de línea base Mínimo: 0 Máximo: 2097152
intrusion	Integer	Riesgo de intrusión Mínimo: 0 Máximo: 2097152
asset_value	String	Importancia de los activos. Las opciones son las siguientes: important common test Mínimo: 0 Máximo: 128
labels	Array of strings	Lista de etiquetas Mínimo: 0 Máximo: 64