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.
Atualizado em 2022-12-29 GMT+08:00

Consulta de status do ECS

Função

Essa API é usada para consultar o status do ECS.

URI

GET /hss/v1/{project_id}/api/host-management/hosts

Tabela 1 Parâmetro de URI

Parâmetro

Obrigatório

Tipo

Descrição

project_id

Sim

String

ID do projeto.

Tabela 2 Parâmetros de consulta

Parâmetro

Obrigatório

Tipo

Descrição

version

Não

String

Edição HSS. Seus valores e seu significado são os seguintes:

  • hss.version.null: nenhum
  • hss.version.basic: edição básica
  • hss.version.enterprise: edição empresarial
  • hss.version.premium: edição premium
  • hss.version.wtp: edição WTP

agent_status

Não

String

Estado do agente. Seu valor pode ser:

  • not_register
  • online
  • offline

host_status

Não

String

Estado do agente. Seu valor pode ser:

  • ACTIVE
  • SHUTOFF
  • BUILDING
  • ERROR

protect_status

Não

String

Estado de proteção. Seu valor pode ser:

  • closed
  • opened

detect_result

Não

String

Estado de proteção. Seu valor pode ser:

  • undetect (não verificado)
  • clean (sem risco)
  • risk (risco detectado)

host_name

Não

String

Nome do servidor

host_ip

Não

String

Endereço IP privado do servidor

public_ip

Não

String

Servidor EIP

os_type

Não

String

Tipo de SO

charging_mode

Não

String

Modo de cobrança. Pode ser:

  • packet_cycle (pacote mensal/anual)
  • on_demand (pagamento pelo uso)

limit

Não

Integer

Valor padrão: 10

offset

Não

Integer

Valor padrão: 0

Parâmetro de solicitação

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

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 (valor de X-Subject-Token no cabeçalho da resposta).

Parâmetros de resposta

Código de estado: 200

Tabela 4 Parâmetros do corpo de resposta

Parâmetro

Tipo

Descrição

total_num

Integer

Número total

data_list

Array of objects

Consulta o status do ECS.

Tabela 5 Host

Parâmetro

Tipo

Descrição

agent_id

String

id do agente

host_id

String

ID do servidor

host_name

String

Nome do servidor

host_ip

String

Endereço IP privado do servidor

public_ip

String

Servidor EIP

enterprise_project_name

String

Nome do projeto empresarial

group_name

String

Nome do grupo de servidores

expire_time

Long

Tempo de expiração do serviço

policy_group_name

String

Nome do grupo de políticas

host_status

String

Estado do agente. Seu valor pode ser:

  • ACTIVE
  • SHUTOFF
  • BUILDING
  • ERROR

agent_status

String

Estado do agente. Seu valor pode ser:

  • uninstall
  • online
  • offline

version

String

Edição HSS. Seus valores e seu significado são os seguintes:

  • hss.version.null: nenhum
  • hss.version.basic: edição básica
  • hss.version.enterprise: edição empresarial
  • hss.version.premium: edição premium
  • hss.version.wtp: edição WTP

protect_status

String

Estado da proteção Seu valor pode ser:

  • closed
  • opened

os_image

String

Imagem do sistema

os_type

String

Tipo de SO

os_bit

String

Versão de bit do SO

detect_result

String

Resultado da varredura do servidor. Seu valor pode ser:

  • undetect (não verificado)
  • clean (sem risco)
  • risk (risco detectado)

risk_port_num

Integer

Número de riscos patrimoniais

risk_vul_num

Integer

Número de vulnerabilidades

risk_intrusion_num

Integer

Número de intrusões

risk_baseline_num

Integer

Número de riscos basais

charging_mode

String

Modo de cobrança. Pode ser:

  • packet_cycle (pacote mensal/anual)
  • on_demand (pagamento por uso)

resource_id

String

ID de instância de recurso de serviço de nuvem (UUID)

Exemplo de solicitação

Nenhum.

Exemplo de resposta

Nenhum.

Código de estado

Código de estado

Descrição

200

A lista de servidores foi obtida.

Código de erro

Para obter detalhes, consulte Códigos de erro.