Consulta de detalhes sobre flavors e informações estendidas sobre flavors
Função
Essa API é usada para consultar detalhes sobre flavors do BMS e informações estendidas sobre os flavors. Você pode chamar essa API para consultar o valor do parâmetro baremetal:extBootType para verificar se um flavor oferece suporte ao provisionamento rápido de BMS.
URI
GET /v1/{project_id}/baremetalservers/flavors?availability_zone={availability_zone}
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. |
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
availability_zone |
Não |
String |
Especifica o nome da AZ. |
Solicitação
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 de BMS.
name
String
Especifica o nome do flavor de BMS.
vcpus
String
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
String
Especifica o tamanho do disco do sistema no flavor do BMS. O valor 0 indica que o tamanho do disco não é limitado.
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.
rxtx_quota
String
Este é um atributo reservado.
rxtx_cap
String
Este é um atributo reservado.
os-flavor-access:is_public
Boolean
Especifica se o flavor é público.
false indica um flavor privado e true indica um flavor público.
links
Array of objects
Especifica links de atalho do flavor. Para mais detalhes, consulte Tabela 4.
os_extra_specs
Object
Especifica campos estendidos do flavor do BMS. Para mais detalhes, consulte Tabela 5.
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. O valor pode ser:
- 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.
type
String
Especifica o tipo de link de atalho.
Tabela 5 Descrição da estrutura de dados do campo os_extra_specs Parâmetro
Tipo
Descrição
resource_type
String
Especifica o tipo de recurso correspondente ao flavor. O valor é ironic.
capabilities:cpu_arch
String
Especifica a arquitetura da CPU do BMS. O valor pode ser:
- x86_64 (aplicável a servidores x86)
- aarch64 (aplicável a servidores ARM)
baremetal:disk_detail
String
Especifica as especificações do disco físico.
capabilities:hypervisor_type
String
Especifica um flavor do tipo Irônico.
baremetal:__support_evs
String
Especifica se o flavor do BMS suporta discos do EVS.
- verdadeiro
- falso
Se o flavor não contiver este parâmetro, os discos do EVS também não são suportados.
baremetal:extBootType
String
Especifica a origem de inicialização do BMS.
- LocalDisk: disco local
- Volume: disco do EVS (provisionamento rápido)
capabilities:board_type
String
Especifica o tipo de flavor do BMS no formato de abreviação de flavor. Por exemplo, se o nome do sabor for physical.o2.medium, o tipo de flavor é o2m.
baremetal:net_num
String
Especifica o número máximo de NICs no BMS.
baremetal:netcard_detail
String
Especifica as especificações físicas da NIC.
baremetal:cpu_detail
String
Especifica as especificações físicas da CPU.
baremetal:memory_detail
String
Especifica especificações de memória física.
cond:operation:status
String
Especifica o status do flavor do BMS. Se este parâmetro não for definido, seu valor padrão é normal.
- normal: indica o uso comercial normal do flavor.
- abandon: indica que o flavor foi desabilitado (não exibido).
- sellout: indica que o flavor foi vendido.
- obt: indica que o flavor está sob OBT.
- promotion: indica o flavor recomendado (uso comercial, que é semelhante ao normal).
cond:operation:az
String
Especifica o status de flavor do BMS em uma AZ.
Este parâmetro tem efeito em toda a AZ. Se uma AZ não estiver configurada neste parâmetro, o valor do parâmetro cond:operation:status será usado por padrão.
Seu formato é az (xx). O xx indica o status do flavor BMS em uma AZ, e é obrigatório. Se xx não for especificado, a configuração é inválida.
Por exemplo, um flavor é para uso comercial em AZ0 e AZ3, esgotado em AZ1, para OBT em AZ2 e cancelado em outros AZs. Em seguida, defina os parâmetros da seguinte forma:
- cond:operation:status: abandon
- cond:operation:az: az0(normal), az1(sellout), az2(obt), az3(promotion)
NOTA:Configure esse parâmetro se o status do flavor em uma AZ for diferente do valor cond:operation:status.
- Exemplo de resposta
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43
{ "flavors": [ { "id": "physical.kl1.3xlarge", "name": "physical.kl1.3xlarge", "vcpus": "24", "ram": 321729, "disk": "6707", "swap": "", "links": [ { "rel": "self", "href": "https://compute.Region.dc1.domainname.com/v2/bbf1946d374b44a0a2a95533562ba954/flavors/physical.kl1.3xlarge", "type": null }, { "rel": "bookmark", "href": "https://compute.Region.dc1.domainname.com/bbf1946d374b44a0a2a95533562ba954/flavors/physical.kl1.3xlarge", "type": null } ], "OS-FLV-EXT-DATA:ephemeral": 0, "rxtx_factor": 1, "OS-FLV-DISABLED:disabled": false, "rxtx_quota": null, "rxtx_cap": null, "os-flavor-access:is_public": false, "os_extra_specs": { "capabilities:cpu_arch": "x86_64", "baremetal:disk_detail": "SAS SSD:2*800G Raid 1 + NVMe SSD Card1.6T", "capabilities:hypervisor_type": "ironic", "baremetal:__support_evs": "true", "baremetal:extBootType": "LocalDisk", "capabilities:board_type": "o2m", "baremetal:net_num": "2", "baremetal:netcard_detail": "2 x 2*10GE", "baremetal:cpu_detail": "Intel Xeon E5-2667 V4 (2*8core* 3.2 GHz)", "resource_type": "ironic", "baremetal:memory_detail": "256GB DDR4 RAM(GB)" } } ] }
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.