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/ Dedicated Host/ Referência de API/ API/ Consulta de ECSs em um DeH

Atualizado em 2024-01-26 GMT+08:00

Ver PDF

Consulta de ECSs em um DeH

Função

Essa API é usada para consultar informações sobre ECSs implementados em um DeH.

URI

GET /v1.0/{project_id}/dedicated-hosts/{dedicated_host_id}/servers

Tabela 1 descreve os parâmetros.

**Tabela 1** Descrição dos parâmetros
Parâmetro	Tipo	Obrigatório	Descrição
project_id	String	Sim	Especifica o ID do projeto. Para obter detalhes sobre como obter o ID do projeto, consulte Obtenção de um ID de projeto.
dedicated_host_id	String	Sim	Especifica o ID do DeH. Você pode obter o valor no console do DeH ou usando a API no Consulta de DeHs.

Solicitação

**Tabela 2** Parâmetros de solicitação
Parâmetro	Em	Tipo	Obrigatório	Descrição
limit	query	String	Não	Especifica o número de registros exibidos por página.
marker	query	String	Não	Especifica o ID do último registro na página anterior. Se o valor do marker for inválido, o código de status 400 será retornado.

Resposta

**Tabela 3** Parâmetros de resposta
Parâmetro	Em	Tipo	Descrição
servers	body	Array of objects	Especifica o objeto do servidor. Para mais detalhes, consulte Tabela 4.

**Tabela 4** Descrição do campo **servers**
Parâmetro	Tipo	Descrição
addresses	Map<String, Object>	Especifica os endereços de rede de um ECS. A estrutura é Map<String, Object>. A chave indica o ID da sub-rede da VPC. O valor indica os atributos de rede especificados em Tabela 5.
created	String	Especifica a hora em que o ECS foi criado.
flavor	Object	Especifica o flavor de ECS. Para mais detalhes, consulte Tabela 6.
id	String	Especifica o ID do ECS no formato UUID.
name	String	Especifica o nome da ECS.
status	String	Especifica o status do ECS. Opções: ACTIVE, BUILD, DELETED, ERROR, HARD_REBOOT, MIGRATING, PASSWORD, PAUSED, REBOOT, REBUILD, RESIZE, REVERT_RESIZE, SHUTOFF, SHELVED, SHELVED_OFFLOADED, SOFT_DELETED, SUSPENDED e VERIFY_RESIZE
tenant_id	String	Especifica o ID do locatário do ECS no formato UUID.
updated	String	Especifica a hora em que o ECS foi atualizado pela última vez.
user_id	String	Especifica o ID do usuário que criou o ECS. O valor está no formato UUID.
task_state	String	Especifica o status da tarefa do ECS.
image	Object	Especifica a imagem do ECS. Para mais detalhes, consulte Tabela 7.
metadata	Object	Especifica os metadados do ECS. Para mais detalhes, consulte Tabela 8.

**Tabela 5** Estrutura de dados da rede à qual um ECS acessa
Parâmetro	Tipo	Descrição
addr	String	Especifica o endereço IP.
version	Integer	Especifica o tipo de um endereço IP. O valor deste parâmetro pode ser 4 ou 6. 4: o tipo do endereço IP é IPv4. 6: o tipo do endereço IP é IPv6.
OS-EXT-IPS-MAC:mac_addr	String	Especifica o endereço MAC. Este é um atributo estendido.
OS-EXT-IPS:type	String	Especifica o modo de atribuição de endereço IP. Este é um atributo estendido.

**Tabela 6** Descrição do campo **flavor**
Parâmetro	Tipo	Descrição
id	String	Especifica o ID do flavor.

**Tabela 7** Descrição do campo de **image**
Parâmetro	Tipo	Descrição
id	String	Especifica o UUID da imagem.

**Tabela 8** Descrição do campo **metadata**
Parâmetro	Tipo	Descrição
os_type	String	Especifica o tipo de SO.

Exemplo de solicitação

GET https://{Endpoint}/v1.0/9c53a566cb3443ab910cf0daebca90c4/dedicated-hosts/ab910cf0daebca90c4001/servers

Exemplo de resposta

{
    "servers": [
        {
          "addresses": {
                "68269e6e-4a27-441b-8029-35373ad50bd9": [
                    {
                        "addr": "192.168.0.3", 
                        "version": 4,
                        "OS-EXT-IPS-MAC:mac_addr": "fa:16:3e:1b:35:78",
                        "OS-EXT-IPS:type": "fixed"
                    }
                ]
            }, 
            "created": "2012-09-07T16:56:37Z", 
            "flavor": {
                "id": "1"
            },
            "id": "05184ba3-00ba-4fbc-b7a2-03b62b884931",
            "metadata": {
                "os_type": "Linux"
            }, 
            "name": "new-server-test", 
            "status": "ACTIVE", 
            "tenant_id": "a90b2728805d4240a72cc2eeb4e1244d", 
            "updated": "2012-09-07T16:56:37Z", 
            "user_id": "fake",
            "task_state": "",
            "image": {
                "id": "1ce5800a-e487-4c1b-b264-3353a39e2b4b"
            }
        }
    ]
}