Consulta de detalhes sobre variantes e informações estendidas sobre variante
Função
Essa API é usada para consultar detalhes sobre variantes de ECS e informações estendidas sobre sabores.
URI
GET /v1/{project_id}/cloudservers/flavors?availability_zone={availability_zone}
Parâmetro | Obrigatório | Descrição |
|---|---|---|
project_id | Sim | Especifica a ID do projeto. Para obter detalhes sobre como obter o ID, consulte Obtenção de um ID de projeto. |
Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
availability_zone | Não | String | Especifique uma AZ. Se este parâmetro não for deixado em branco, as variantes no estado normal, obt, ou promotion serão retornados. Consulte Regiões e. |
Solicitação
Nenhum
Resposta
Parâmetro | Tipo | Descrição |
|---|---|---|
flavors | Array of objects | Especifica variantes de ECS. Para mais detalhes, consulte Tabela 4. |
Parâmetro | Tipo | Descrição |
|---|---|---|
id | String | Especifica a ID da variante de ECS. |
name | String | Especifica o nome do variante de ECS. |
vcpus | String | Especifica o número das vCPU na variante de ECS. |
ram | Integer | Especifica o tamanho da memória (MB) na variante de ECS. |
disk | String | Especifica o tamanho do disco do sistema na variante de ECS. Este parâmetro não foi utilizado. O valor padrão é 0. |
swap | String | Especifica o tamanho da partição de swap exigido pela variante de ECS. Este parâmetro não foi utilizado. Seu valor padrão é "”. |
OS-FLV-EXT-DATA:ephemeral | Integer | Especifica o tamanho do disco temporário. Este é um atributo estendido. Este parâmetro não foi utilizado. O valor padrão é 0. |
OS-FLV-DISABLED:disabled | Boolean | Especifica se a variante de ECS foi desativado. Este é um atributo estendido. Este parâmetro não foi utilizado. O valor padrão é false. |
rxtx_factor | Float | Especifica a proporção da largura de banda de rede disponível para a largura de banda de hardware de rede do ECS. Este parâmetro não foi utilizado. Seu valor padrão é 1.0. |
rxtx_quota | String | Especifica as restrições de software da largura de banda da rede que podem ser usadas pelo ECS. Este parâmetro não foi utilizado. O valor padrão é null. |
rxtx_cap | String | Especifica as restrições de hardware da largura de banda de rede que podem ser usadas pelo ECS. Este parâmetro não foi utilizado. O valor padrão é null. |
os-flavor-access:is_public | Boolean | Especifica se uma variante está disponível para todos os inquilinos. Este é um atributo estendido.
Valor padrão: true |
links | Array of objects | Especifica links de atalho para variantes de ECS. Para mais detalhes, consulte Tabela 5. |
os_extra_specs | Object | Especifica especificações de ECS estendidas. Para mais detalhes, consulte Tabela 6. |
attachableQuantity | Object | Especifica o número das NIC e discos que podem ser anexados a um ECS. Para mais detalhes, consulte Tabela 7. |
Parâmetro | Tipo | Descrição |
|---|---|---|
rel | String | Especifica o nome do marcador do link de atalho. |
href | String | Fornece o link de atalho correspondente. |
type | String | Especifica o tipo de link de atalho. Este parâmetro não foi utilizado. O valor padrão é null. |
Parâmetro | Tipo | Descrição |
|---|---|---|
ecs:performancetype | String | Especifica o tipo da variante de ECS:
|
hw:numa_nodes | String | Especifica o número das CPU físicas do host. A variante de ECS determina se o valor do parâmetro deve ser retornado. |
resource_type | String | Especifica o tipo de recurso. resource_type é usado para diferenciar entre os tipos de servidores físicos que acomodam os ECS. |
hpet_support | String | Especifica se o relógio de alta precisão deve ser ativado no ECS. true indica para ativar a função, e false indica para desativar a função. As especificações de ECS determinam se deve retornar o valor do parâmetro. |
instance_vnic:type | String | Especifica o tipo de NIC. O valor desse parâmetro é consistentemente enhanced, indicando que os ECS de aprimoramento da rede devem ser criados. |
instance_vnic:instance_bandwidth | String | Especifica a largura de banda máxima na unidade de Mbit/s. O valor máximo deste parâmetro é 10000. |
instance_vnic:max_count | String | Especifica o número máximo das NIC. O valor máximo deste parâmetro é 4. |
quota:local_disk | String | O valor deste parâmetro está no formato de "{type}:{count}:{size}:{safeFormat}", onde,
NOTA: Este campo é dedicado para os ECS com uso intensivo de disco. |
quota:nvme_ssd | String | O valor deste parâmetro está no formato de {type}:{spec}:{num}:{size}:{safeFormat}:.
NOTA: Este campo é dedicado para os ECS de E/S ultra-altas. |
extra_spec:io:persistent_grant | String | Especifica se a persistência é suportada. O valor deste parâmetro é true. Esse parâmetro indica que o ECS está autorizado persistentemente a acessar o armazenamento. NOTA: Esse campo é dedicado para os ECS D1 com uso intensivo de disco. |
ecs:generation | String | Especifica a geração de um tipo de ECS. Por exemplo, 3 em s3 indica os ECS de terceira geração de uso geral. Para obter detalhes sobre variações e gerações, consulte Especificações do ECS no Guia de usuário do Elastic Cloud Server. |
ecs:virtualization_env_types | String | Especifica um tipo de virtualização.
NOTA: Este campo é opcional. |
cond:operation:status | String | Este parâmetro tem efeito em toda a região. Se uma AZ não estiver configurada no parâmetro cond:operation:az, o valor deste parâmetro será usado por padrão. Se este parâmetro não for definido ou usado, o significado de normal se aplica. Opções:
|
cond:operation:az | String | Este parâmetro tem efeito AZ-wide. Se uma AZ não estiver configurada neste parâmetro, o valor do parâmetro cond:operation:status será usado por padrão. Este parâmetro está no formato de "az(xx)". O valor entre parênteses é o status do sabor em uma AZ. Se os parênteses forem deixados em branco, a configuração é inválida. As opções cond:operation:az são as mesmas que as opções cond:operation:status. Por exemplo, um sabor é para uso comercial nas AZ 0 e 3, esgotado em AZ 1, para OBT em AZ 2, e é cancelado nas outras AZ. Em seguida, defina os parâmetros da seguinte forma:
NOTA: Configure esse parâmetro se o status da variação em uma AZ for diferente do valor cond:operation:status. |
quota:max_rate | String | Especifica a largura de banda máxima.
|
quota:min_rate | String | Especificada a largura de banda assegurada.
|
quota:max_pps | String | Especifica o PPS máximo da intranet.
|
cond:operation:charge:stop | String | Especifica se as taxas são cobradas para um ECS interrompido.
|
cond:operation:charge | String | Especifica um tipo de faturamento.
|
cond:spot:operation:az | String | Especifica a AZ para as variações no modo de faturamento de preços à vista. |
cond:operation:roles | String | Especifica as funções permitidas. Marca de usuário correspondente (roles op_gatexxx), que está disponível para todos os usuários se este parâmetro não estiver definido |
cond:spot:operation:status | String | Especifica o status de uma variação no modo de faturamento de preço à vista.
|
cond:network | String | Especifica restrições de rede. Os recursos de rede são suportados. Se esse parâmetro não for definido, a configuração padrão no console será usada. |
cond:storage | String | Especifica restrições de armazenamento.
|
cond:compute:live_resizable | String | Especifica restrições de computação.
|
cond:compute | String | Especifica restrições de computação.
|
ecs:instance_architecture | String | Especifica a arquitetura da CPU correspondente ao sabor. Este parâmetro é retornado somente para os ECS Kunpeng. O valor arm64 indica que a arquitetura da CPU é Kunpeng. |
info:gpu:name | String | Especifica o número e os nomes das GPU. |
info:cpu:name | String | Especifica o nome da CPU. |
quota:gpu | String | Especifica o nome da GPU. |
Parâmetro | Tipo | Descrição |
|---|---|---|
free_scsi | Integer | Especifica o número de discos SCSI que podem ser anexados. |
free_blk | Integer | Especifica o número de discos VBD que podem ser anexados. |
free_disk | Integer | Especifica o número de discos que podem ser anexados. |
free_nic | Integer | Especifica o número de NICs que podem ser anexadas. |

Para obter mais informações, consulte "Especificações e tipos de ECS" no Guia de usuário do Elastic Cloud Server.
Exemplo de solicitação
GET https://{endpoint}/v1/{project_id}/cloudservers/flavors?availability_zone=availability_value Exemplo de resposta
{
"flavors": [
{
"attachableQuantity": {
"free_scsi": 60,
"free_blk": 24,
"free_disk": 60,
"free_nic": 12
},
"id": "c3.2xlarge.2",
"name": "c3.2xlarge.2",
"vcpus": "8",
"ram": 16384,
"disk": "0",
"swap": "",
"links": [
{
"rel": "self",
"href": "https://ecs.region.xxx.com/v1.0/743b4c0428d94531b9f2add666642e6b/flavors/c3.2xlarge.2",
"type": null
},
{
"rel": "bookmark",
"href": "https://ecs.region.xxx.com/743b4c0428d94531b9f2add666642e6b/flavors/c3.2xlarge.2",
"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": true,
"os_extra_specs": {
"ecs:virtualization_env_types": "CloudCompute",
"ecs:generation": "c3",
"ecs:instance_architecture":"arm64" ,
"ecs:performancetype": "computingv3",
"resource_type": "IOoptimizedC3_2"
}
}
]
} Valores retornados
Código de erro
Consulte Códigos de erro.

