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 de host> Consulta dos ECSs

Atualizado em 2022-12-29 GMT+08:00

Ver PDF

Consulta dos ECSs

Função

Essa API é usada para consultar ECSs.

URI

GET /v5/{project_id}/host-management/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: 1 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 Padrão: 0 Mínimo: 0 Máximo: 256
version	Não	String	Edição HSS. As opções são as 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 hss.version.container.enterprise: edição de container Mínimo: 1 Máximo: 64
agent_status	Não	String	Estado do agente. As opções são as seguintes: not_ installed online offline install_failed installing not_online: todos os status exceto online, que é usado somente como uma condição de consulta. Mínimo: 1 Máximo: 12
detect_result	Não	String	Resultado da detecção. As opções são as seguintes: undetected clean risk scanning Mínimo: 1 Máximo: 32
host_name	Não	String	Nome do servidor Mínimo: 0 Máximo: 128
host_id	Não	String	ID do servidor Mínimo: 0 Máximo: 128
host_status	Não	String	Status do host. As opções são as seguintes: ACTIVE SHUTOFF BUILDING ERROR Mínimo: 1 Máximo: 32
os_type	Não	String	Tipo de SO. As opções são as seguintes: Linux Windows Mínimo: 0 Máximo: 64
private_ip	Não	String	Endereço IP privado do servidor Mínimo: 0 Máximo: 128
public_ip	Não	String	Endereço IP público do servidor Mínimo: 0 Máximo: 128
ip_addr	Não	String	Endereço IP público ou privado Mínimo: 0 Máximo: 128
protect_status	Não	String	Estado da proteção As opções são as seguintes: closed opened Mínimo: 1 Máximo: 32
group_id	Não	String	ID do grupo de servidores Mínimo: 0 Máximo: 128
group_name	Não	String	Nome do grupo de servidores Mínimo: 0 Máximo: 256
policy_group_id	Não	String	ID do grupo de políticas Mínimo: 0 Máximo: 128
policy_group_name	Não	String	Nome do grupo de políticas Mínimo: 0 Máximo: 256
charging_mode	Não	String	Modo de cobrança. As opções são as seguintes: packet_cycle: anual/mensal on_demand: pagamento por uso Mínimo: 1 Máximo: 32
refresh	Não	Boolean	Se for preciso sincronizar servidores a partir de ECSs
above_version	Não	Boolean	Se deseja retornar todas as versões posteriores à versão atual
outside_host	Não	Boolean	Se um servidor é um servidor da Huawei Cloud
asset_value	Não	String	Importância patrimonial. As opções são as seguintes: important common test Mínimo: 0 Máximo: 128
label	Não	String	Etiqueta de ativo Mínimo: 1 Máximo: 64
limit	Não	Integer	Número de registros exibidos em cada página. O valor padrão é 10. 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 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
region	Não	String	id da região Mínimo: 0 Máximo: 128

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 de registros Mínimo: 0 Máximo: 2097152
data_list	Array of Host objects	Consulta sobre o status e a lista do servidor de nuvem

**Tabela 5** Host
Parâmetro	Tipo	Descrição
host_name	String	Nome do servidor Mínimo: 0 Máximo: 128
host_id	String	ID do servidor Mínimo: 0 Máximo: 128
agent_id	String	ID do agente Mínimo: 0 Máximo: 128
private_ip	String	Endereço IP privado Mínimo: 0 Máximo: 128
public_ip	String	endereço IP elástico Mínimo: 0 Máximo: 128
enterprise_project_name	String	Nome do projeto empresarial Mínimo: 0 Máximo: 256
host_status	String	Status do servidor. As opções são as seguintes: ACTIVE SHUTOFF BUILDING ERROR Mínimo: 1 Máximo: 32
agent_status	String	Estado do agente. As opções são as seguintes: not_ installed online offline install_failed installing Mínimo: 1 Máximo: 32
install_result_code	String	Resultado da instalação. As opções são as seguintes: install_succeed network_access_timeout: tempo limite da conexão. Erro de rede. invalid_port auth_failed: a autenticação falhou devido à senha incorreta. permission_denied: permissões insuficientes. no_available_vpc: não há servidores com um agente on-line na VPC atual. install_exception invalid_param install_failed package_unavailable os_type_not_support: tipo de SO incorreto os_arch_not_support: arquitetura incorreta do SO Mínimo: 1 Máximo: 32
version	String	Edição HSS. As opções são as 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 hss.version.container.enterprise: edição de container Mínimo: 1 Máximo: 32
protect_status	String	Estado da proteção As opções são as seguintes: closed opened Mínimo: 1 Máximo: 32
os_image	String	Imagem de disco do sistema Mínimo: 0 Máximo: 128
os_type	String	Tipo de SO. As opções são as seguintes: Linux Windows Mínimo: 0 Máximo: 128
os_bit	String	Versão de bit do SO Mínimo: 0 Máximo: 128
detect_result	String	Resultado da varredura do servidor. As opções são as seguintes: undetected clean risk scanning Mínimo: 1 Máximo: 32
charging_mode	String	Modo de cobrança. As opções são as seguintes: packet_cycle: anual/mensal on_demand: pagamento por uso Mínimo: 1 Máximo: 32
resource_id	String	ID de instância de recurso de serviço de nuvem (UUID) Mínimo: 0 Máximo: 128
outside_host	Boolean	Se um servidor é um servidor de não-Huawei Cloud
group_id	String	ID do grupo de servidores Mínimo: 1 Máximo: 128
group_name	String	Nome do grupo de servidores Mínimo: 1 Máximo: 128
policy_group_id	String	ID do grupo de políticas Mínimo: 1 Máximo: 128
policy_group_name	String	Nome do grupo de políticas Mínimo: 1 Máximo: 128
asset	Integer	Risco patrimonial Mínimo: 0 Máximo: 2097152
vulnerability	Integer	vulnerabilidade Mínimo: 0 Máximo: 2097152
baseline	Integer	Riscos basais Mínimo: 0 Máximo: 2097152
intrusion	Integer	Risco de intrusão Mínimo: 0 Máximo: 2097152
asset_value	String	Importância patrimonial. As opções são as seguintes: important common test Mínimo: 0 Máximo: 128
labels	Array of strings	Lista de tag Mínimo: 0 Máximo: 64