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 2024-01-26 GMT+08:00

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
}

Código de status

Consulte Códigos de status.