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> Elastic Cloud Server> Referência de API> As API da Nova do OpenStack> Gerenciamento de variante> Consulta de variantes de ECS

Atualizado em 2022-11-08 GMT+08:00

Consulta de variantes de ECS

Função

Essa API é usada para consultar variantes de ECS disponíveis. Depois de receber a solicitação, o Nova usa nova-api para visualizar os sabores do banco de dados.

URI

GET /v2.1/{project_id}/flavors?minDisk={minDisk}&minRam={minRam}&sort_key={sort_key}&sort_dir={sort_dir}

Tabela 1 descreve os parâmetros no URI.

**Tabela 1** Parâmetros de caminho
Parâmetro	Obrigatório	Descrição
project_id	Sim	Especifica a ID do projeto. Para obter detalhes de como conseguir o ID de domínio, consulte Obtenção de um ID de projeto.

A consulta de paginação é suportada. Para mais detalhes, consulte Consulta de dados em páginas.

Os parâmetros da tabela a seguir podem ser usados como parâmetros de URI para filtrar os resultados da consulta. Uso: /v2/{project_id}/flavors?minDisk={minDisk}&minRam={minRam}

Tabela 2 descreve os parâmetros de solicitação.

**Tabela 2** Parâmetros de consulta
Parâmetro	Obrigatório	Tipo	Descrição
minDisk	Não	Integer	Especifica a especificação mínima de disco na unidade de GB. Somente os ECS com a especificação de disco maior ou igual à especificação mínima podem ser consultados.
minRam	Não	Integer	Especifica o mínimo de RAM na unidade de MB. Somente os ECS com a especificação de RAM maior ou igual à especificação mínima podem ser consultados.
sort_key	Não	String	Indica um campo de classificação, cujo valor padrão é flavorid. O valor deste parâmetro também pode ser name, memory_mb, vcpus, root_gb, ou flavorid.
sort_dir	Não	String	Especifica a ordenação ascendente (asc) ou descendente (desc). O valor padrão é asc.

Solicitação

Nenhum

Resposta

Tabela 4 descreve os parâmetros de resposta.

**Tabela 3** Parâmetros de resposta
Parâmetro	Tipo	Descrição
flavors	Array of objects	Especifica variantes de ECS. Para mais detalhes, consulte Tabela 4.
flavors_links	Array of objects	Especifica links de dados para consultar as próximas páginas na consulta de paginação. Para mais detalhes, consulte Tabela 5.

**Tabela 4** descrição do campo de **flavors**
Parâmetro	Tipo	Descrição
id	String	Especifica o ID do sabor.
links	Array of objects	Especifica o link de atalho da variante ECS. Para mais detalhes, consulte Tabela 5.
name	String	Especifica o nome do variante.

**Tabela 5** descrição do campo **links**
Parâmetro	Tipo	Descrição
rel	String	Especifica o nome do marcador do link de atalho.
href	String	Especifica o link de atalho.

Exemplo de solicitação

GET https://{endpoint}/v2.1/743b4c0428d94531b9f2add666642e6b/flavors

Exemplo de resposta

{
    "flavors": [
        {
            "id": "c3.medium",
            "links": [
                {
                    "href": "https://compute.region.xxx.com/v2.1/743b4c0428d94531b9f2add666642e6b/flavors/c3.medium",
                    "rel": "self"
                },
                {
                    "href": "https://compute.region.xxx.com/743b4c0428d94531b9f2add666642e6b/flavors/c3.medium",
                    "rel": "bookmark"
                }
            ],
            "name": "c3.medium"
        },
        {
            "id": "c3.xlarge",
            "links": [
                {
                    "href": "https://compute.region.xxx.com/v2.1/743b4c0428d94531b9f2add666642e6b/flavors/c3.xlarge",
                    "rel": "self"
                },
                {
                    "href": "https://compute.region.x.com/743b4c0428d94531b9f2add666642e6b/flavors/c3.xlarge",
                    "rel": "bookmark"
                }
            ],
            "name": "c3.xlarge"
        }
    ]
}