Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.
Central de ajuda> Host Security Service (New)> Referência de API> Gerenciamento da linha de base> Consulta da lista de servidores afetados de um item de configuração de segurança especificado
Atualizado em 2022-12-29 GMT+08:00

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

Tabela 1 Parâmetros de caminho

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

Tabela 2 Parâmetros de consulta

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:

  • cn_standard: padrão de certificação de segurança
  • hw_standard: padrão da Huawei
  • qt_standard: padrão de Qingteng

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

Tabela 3 Parâmetros de cabeçalho de solicitação

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

Tabela 4 Parâmetros do corpo de resposta

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

Tabela 5 SecurityCheckHostInfoResponseInfo

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.