Consulta da lista de servidores afetados de um item de configuração de segurança especificado
Função
Essa API é usada para consultar a lista de servidores afetados de um item de configuração de segurança especificado.
URI
GET /v5/{project_id}/baseline/risk-config/{check_type}/hosts
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
project_id |
Sim |
String |
ID do projeto do locatário Mínimo: 20 Máximo: 64 |
check_type |
Sim |
String |
Nome da linha de base Mínimo: 0 Máximo: 256 |
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
enterprise_project_id |
Não |
String |
ID do projeto empresarial Mínimo: 0 Máximo: 64 |
standard |
Sim |
String |
Tipo padrão. As opções são as seguintes:
Mínimo: 0 Máximo: 32 |
host_name |
Não |
String |
Nome do servidor Mínimo: 0 Máximo: 256 |
host_ip |
Não |
String |
Endereço IP do servidor Mínimo: 0 Máximo: 256 |
limit |
Não |
Integer |
Número de registros 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 de usuário, que 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 é o token do usuário. Mínimo: 32 Máximo: 2097152 |
Parâmetros de resposta
Código de estado: 200
Parâmetro |
Tipo |
Descrição |
---|---|---|
total_num |
Long |
Volume total de dados Mínimo: 0 Máximo: 2147483647 |
data_list |
Array of SecurityCheckHostInfoResponseInfo objects |
Lista de dados |
Parâmetro |
Tipo |
Descrição |
---|---|---|
host_id |
String |
ID do servidor Mínimo: 0 Máximo: 64 |
host_name |
String |
Nome do servidor Mínimo: 0 Máximo: 256 |
host_public_ip |
String |
Endereço IP público do servidor Mínimo: 0 Máximo: 128 |
host_private_ip |
String |
Endereço IP privado do servidor Mínimo: 0 Máximo: 256 |
scan_time |
Long |
Tempo de varredura Mínimo: 0 Máximo: 9223372036854775807 |
failed_num |
Integer |
Número de elementos de risco Mínimo: 0 Máximo: 2147483647 |
passed_num |
Integer |
Número de itens passados Mínimo: 0 Máximo: 2147483647 |
Exemplos de solicitações
Nenhum
Exemplo de respostas
Nenhum
Códigos de estado
Código de estado |
Descrição |
---|---|
200 |
A lista de servidores afetados por um item de configuração de segurança especificado é retornada. |
Códigos de erro
Consulte Códigos de erro.