Consulta da lista de vulnerabilidades
Função
Essa API é usada para consultar a lista de vulnerabilidades detectadas.
URI
GET /v5/{project_id}/vulnerability/vulnerabilities
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
project_id |
Sim |
String |
ID do projeto do locatário Mínimo: 1 Máximo: 256 |
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
enterprise_project_id |
Não |
String |
ID do locatário da empresa Padrão: 0 Mínimo: 0 Máximo: 256 |
type |
Não |
String |
Tipo de vulnerabilidade. As opções são as seguintes: -linux_vul -windows_vul -web_cms Mínimo: 0 Máximo: 32 |
vul_id |
Sim |
String |
ID da vulnerabilidade Mínimo: 0 Máximo: 256 |
vul_name |
Não |
String |
Nome da vulnerabilidade Mínimo: 0 Máximo: 256 |
limit |
Não |
Integer |
Número de registros exibidos em cada página Mínimo: 0 Máximo: 200 Padrão: 10 |
offset |
Não |
Integer |
Deslocamento, que especifica a posição inicial do registro a ser retornado. O valor deve ser um número não menor que 0. O valor padrão é 0. Mínimo: 0 Máximo: 100000 Padrão: 0 |
Solicitação dos parâmetros
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
x-auth-token |
Sim |
String |
Token do usuário. Ele pode ser obtido chamando a API do IAM usada para obter um token de usuário. O valor de X-Subject-Token no cabeçalho da resposta é um token. Mínimo: 1 Máximo: 32768 |
Parâmetros de resposta
Código de estado: 200
Parâmetro |
Tipo |
Descrição |
---|---|---|
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 |
Parâmetro |
Tipo |
Descrição |
---|---|---|
vul_name |
String |
Nome da vulnerabilidade Mínimo: 0 Máximo: 256 |
vul_id |
String |
ID da vulnerabilidade Mínimo: 0 Máximo: 64 |
label_list |
Array of strings |
Tag de vulnerabilidade Mínimo: 0 Máximo: 65534 |
repair_necessity |
Integer |
Necessidade de reparar Mínimo: 0 Máximo: 2147483647 |
host_num |
Integer |
Número de servidores afetados Mínimo: 0 Máximo: 2147483647 |
unhandle_host_num |
Integer |
Número de servidores não tratados Mínimo: 0 Máximo: 2147483647 |
scan_time |
Long |
Hora da última varredura Mínimo: 0 Máximo: 9223372036854775807 |
solution_detail |
String |
Solução Mínimo: 0 Máximo: 65534 |
url |
String |
URL de vulnerabilidade Mínimo: 0 Máximo: 2083 |
description |
String |
Descrição da vulnerabilidade Mínimo: 0 Máximo: 65534 |
type |
String |
Tipo de vulnerabilidade. As opções são as seguintes:-linux_vul -windows_vul -web_cms Mínimo: 0 Máximo: 128 |
host_id_list |
Array of strings |
Lista de anfitriões Mínimo: 0 Máximo: 128 |
Exemplos de solicitações
Nenhum
Exemplo de respostas
Nenhum
Códigos de estado
Código de estado |
Descrição |
---|---|
200 |
A lista de vulnerabilidades detectadas é retornada. |
Códigos de erro
ConsulteCódigos de erro.