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 vulnerabilidades/ Consulta de la lista de vulnerabilidades

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

Ver PDF

Consulta de la lista de vulnerabilidades

Función

Esta API se utiliza para consultar la lista de vulnerabilidades detectadas.

URI

GET /v5/{project_id}/vulnerability/vulnerabilities

**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 de inquilino de empresa Predeterminado: 0 Mínimo: 0 Máximo: 256
type	No	String	Tipo de vulnerabilidad. Las opciones son las siguientes: -linux_vul -windows_vul -web_cms Mínimo: 0 Máximo: 32
vul_id	Yes	String	ID de vulnerabilidad Mínimo: 0 Máximo: 256
vul_name	No	String	Nombre de la vulnerabilidad Mínimo: 0 Máximo: 256
limit	No	Integer	Número de registros mostrados en cada página 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

Parámetros de respuesta

Código de estado: 200

**Tabla 4** Parámetros de body de respuesta
Parámetro	Tipo	Descripción
total_num	Long	Número total de vulnerabilidades de software Mínimo: 0 Máximo: 2147483647
data_list	Array of VulInfo objects	Lista de vulnerabilidades de software

**Tabla 5** VulInfo
Parámetro	Tipo	Descripción
vul_name	String	Nombre de la vulnerabilidad Mínimo: 0 Máximo: 256
vul_id	String	ID de vulnerabilidad Mínimo: 0 Máximo: 64
label_list	Array of strings	Etiqueta de vulnerabilidad Mínimo: 0 Máximo: 65534
repair_necessity	Integer	Necesidad de reparar Mínimo: 0 Máximo: 2147483647
host_num	Integer	Cantidad de servidores afectados Mínimo: 0 Máximo: 2147483647
unhandle_host_num	Integer	Número de servidores no controlados Mínimo: 0 Máximo: 2147483647
scan_time	Long	Último tiempo de escaneo Mínimo: 0 Máximo: 9223372036854775807
solution_detail	String	Solución Mínimo: 0 Máximo: 65534
url	String	URL de vulnerabilidad Mínimo: 0 Máximo: 2083
description	String	Descripción de la vulnerabilidad Mínimo: 0 Máximo: 65534
type	String	Tipo de vulnerabilidad. Las opciones son las siguientes:-linux_vul -windows_vul -web_cms Mínimo: 0 Máximo: 128
host_id_list	Array of strings	Lista de hosts Mínimo: 0 Máximo: 128