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 DeHs

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

Ver PDF

Consulta de DeHs

Função

Esta API é usada para consultar a lista de DeH.

URI

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

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.

Solicitação

Você pode adicionar parâmetros host_type, host_type_name, flavor, dedicated_host_id, state, tenant, availability_zone, name, limit, marker, tags, instance_uuid ou changes-since ao URI para filtrar o resultado da pesquisa.

Por exemplo, /v1.0/{project_id}/dedicated-hosts?host_type={host_type}&state={state}.

**Tabela 2** Parâmetros de solicitação
Parâmetro	Em	Tipo	Obrigatório	Descrição
dedicated_host_id	query	String	Não	Especifica o ID do DeH.
name	query	String	Não	Especifica o nome do DeH.
host_type	query	String	Não	Especifica o tipo do DeH.
host_type_name	query	String	Não	Especifica o nome do tipo do DeH.
flavor	query	String	Não	Especifica o ID do flavor.
state	query	String	Não	Especifica o status do DeH. O valor pode estar available, fault ou released.
tenant	query	String	Não	O valor pode ser um ID de locatário ou all. Somente usuários com permissões de administrador do DeH podem especificar esse campo.
availability_zone	query	String	Não	Especifica a AZ à qual o DeH pertence.
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.
tags	query	String	Não	Especifica as tags do DeH.
instance_uuid	query	String	Não	Especifica o ID do ECS no DeH.
changes-since	query	String	Não	Filtra a resposta por data e hora quando o status do DeH é alterado. Para ajudar a manter o controle das alterações, este parâmetro também pode exibir DeHs excluídos recentemente. O formato da data e do carimbo de data/hora é ISO 8601: CCYY-MM-DDThh:mm:ss±hh:mm Se o valor hh:mm for incluído, o fuso horário será retornado como o deslocamento UTC, por exemplo, 2015-08-27T09:49:58-05:00. Se você omitir o fuso horário, o fuso horário UTC será assumido.

Resposta

**Tabela 3** Parâmetros de resposta
Parâmetro	Em	Tipo	Descrição
dedicated_hosts	body	Array of objects	Especifica os DeHs que atendem aos critérios de pesquisa. Para mais detalhes, consulte Tabela 1.
total	body	Integer	Especifica a quantidade de DeHs que atendem aos critérios de pesquisa.

Exemplo de solicitação

Consulte os DeHs no estado available.

GET https://{Endpoint}/v1.0/9c53a566cb3443ab910cf0daebca90c4/dedicated-hosts?state=available

Exemplo de resposta

{
    "dedicated_hosts": [
        {
            "dedicated_host_id": "d465d0ae-f859-4a83-a508-8db654c05e7e",
            "name": "DEH001",
            "auto_placement": "off",
            "availability_zone": "cn-east-3a",
            "host_properties": {
                "vcpus": 74,
                "cores": 22,
                "sockets": 2,
                "memory": 151552,
                "host_type": "c6",
                "host_type_name": "dedicated_general_purpose",
                "available_instance_capacities": [
                    {
                        "flavor": "c6.large.2"
                    },
                    {
                        "flavor": "c6.xlarge.2"
                    },
                    {
                        "flavor": "c6.2xlarge.2"
                    },
                    {
                        "flavor": "c6.3xlarge.2"
                    },
                    {
                        "flavor": "c6.6xlarge.2"
                    },
                    {
                        "flavor": "c6.16xlarge.2"
                    }
                ]
            },
            "state": "available",
            "project_id": "9c53a566cb3443ab910cf0daebca90c4",
            "available_vcpus": 20,
            "available_memory": 40960,
            "instance_total": 5,
            "allocated_at": "2016-10-10T14:35:47Z",
            "released_at": null
            }
            ],
    "total": 1
}