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.
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}.
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
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
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.