Consulta de flavors do BMS (API OpenStack nativo)
Função
Essa API é usada para consultar flavors do BMS.
Restrições
Os flavors que você obteve usando essa API são todos os flavors no sistema. Os flavors cujos nomes começam com physical são flavors do BMS e podem ser usados para criar BMSs.
URI
GET /v2.1/{project_id}/flavors/detail{?minDisk={minDisk}&minRam={minRam}&sort_key={sort_key}&sort_dir={sort_dir}}
A Tabela 1 lista os parâmetros.
Parâmetro |
Obrigatório |
Descrição |
---|---|---|
project_id |
Sim |
Especifica o ID do projeto. Para obter detalhes de como conseguir o ID de domínio, consulte Obtenção de um ID de projeto. |
A Tabela 2 lista os parâmetros opcionais que podem ser usados para consultar flavors do BMS.
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
minDisk |
Não |
String |
Especifica o tamanho mínimo do disco em GB. Somente os BMSs com um tamanho de disco maior ou igual ao tamanho mínimo podem ser consultados. |
minRam |
Não |
String |
Especifica o tamanho mínimo da memória em MB. Somente os BMSs com o tamanho de memória maior ou igual ao tamanho mínimo podem ser consultados. |
sort_key |
Não |
String |
Especifica o campo de classificação. O 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 classificação de flavors do BMS. O valor pode ser asc ou desc, e é asc por padrão. |
Solicitação
- Parâmetros de solicitação
- Exemplo de solicitação
- Sem nenhum parâmetro opcional
1
GET https://{ECS Endpoint}/v2.1/bbf1946d374b44a0a2a95533562ba954/flavors/detail
- Com um parâmetro opcional
1
GET https://{ECS Endpoint}/v2.1/bbf1946d374b44a0a2a95533562ba954/flavors/detail?minDisk=3725
- Com vários parâmetros opcionais
1
GET https://{ECS Endpoint}/v2.1/bbf1946d374b44a0a2a95533562ba954/flavors/detail?minDisk=3725&is_public=true
- Sem nenhum parâmetro opcional
Resposta
- Parâmetros de resposta
Parâmetro
Tipo
Descrição
flavors
Array of objects
Especifica os flavors de BMS. Para mais detalhes, consulte Tabela 3.
Tabela 3 Descrição da estrutura de dados do campo flavors Parâmetro
Tipo
Descrição
id
String
Especifica o ID do flavor do BMS.
name
String
Especifica o nome do flavor do BMS.
vcpus
Integer
Especifica o número de núcleos de CPU no flavor do BMS.
ram
Integer
Especifica o tamanho da memória (MB) no flavor do BMS.
disk
Integer
Especifica o tamanho do disco (GB) no flavor do BMS.
swap
String
Este é um atributo reservado.
OS-FLV-EXT-DATA:ephemeral
Integer
Este é um atributo reservado.
OS-FLV-DISABLED:disabled
Boolean
Este é um atributo reservado.
rxtx_factor
Float
Este é um atributo reservado.
os-flavor-access:is_public
Boolean
Este é um atributo reservado.
links
Array of objects
Especifica links de atalho do flavor do BMS. Para mais detalhes, consulte Tabela 4.
Tabela 4 Descrição da estrutura de dados do campo links Parâmetro
Tipo
Descrição
rel
String
Especifica o nome do marcador do link de atalho.
- self: link de recurso que contém o número da versão. É usado quando o rastreamento imediato é necessário.
- bookmark: link de recurso que pode ser armazenado por um longo tempo.
href
String
Especifica o link de atalho correspondente.
- Exemplo de resposta
{ "flavors": [ { "name": "physical.o2.medium", "links": [ { "href": "https://openstack.example.com/v2/c685484a8cc2416b97260938705deb65/flavors/physical.o2.medium", "rel": "self" }, { "href": "https://openstack.example.com/c685484a8cc2416b97260938705deb65/flavors/physical.o2.medium", "rel": "bookmark" } ], "ram": 321725, "OS-FLV-DISABLED:disabled": false, "vcpus": 56, "swap": "", "os-flavor-access:is_public": true, "rxtx_factor": 1, "OS-FLV-EXT-DATA:ephemeral": 0, "disk": 3725, "id": "physical.o2.medium" } ] }
Valores retornados
Valores retornados |
Descrição |
---|---|
200 |
A solicitação foi processada com sucesso. |
Para obter detalhes sobre outros valores retornados, consulte Códigos de status.
Códigos de erro
Consulte Códigos de erro.