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 (recomendado)/ Gerenciamento de variante/ Consulta de detalhes sobre variantes e informações estendidas sobre variante

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

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}

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 sobre como obter o ID, consulte Obtenção de um ID de projeto.

**Tabela 2** Parâmetros de consulta
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

Tabela 3 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.

**Tabela 4** descrição do campo de **flavors**
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. true: indica que um sabor está disponível para todos os locatários. false: indica que um sabor está disponível apenas para determinados inquilinos. 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.

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

**Tabela 6** Descrição do campo **os_extra_specs** (apenas parâmetros comuns são listados)
Parâmetro	Tipo	Descrição
ecs:performancetype	String	Especifica o tipo da variante de ECS: normal: computação geral cpuv1: computação I cpuv2: computação II computingv3: general computing-plus highmem: otimizado para memória saphana: memória grande HANA ECS diskintensive: com uso intensivo de disco
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, type: indica o tipo de disco, que só pode ser HDD. count: indica o número de discos locais. Para os ECS D1, o valor pode ser 3, 6, 12 ou 24. Para os ECS D2, o valor pode ser 2, 4, 8, 12, 16 ou 24. Para os ECS D3, o valor pode ser 2, 4, 8, 12, 16, 24 ou 28. size: indica a capacidade de um único disco, em GB. Atualmente, apenas 1675 é suportado. O tamanho real do disco é 1800 e o tamanho disponível após a formatação é 1675. safeFormat: indica se os discos locais do ECS estão formatados com segurança. Para os ECS D1, o valor é FALSE. Para os ECS D2 ou D3, o valor é True. 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}:. type: indica a capacidade de um único disco SSD NVME conectado ao ECS, que só pode ser de 1,6 TB ou 3,2 TB. spec: indica a especificação do disco SSD NVME, que pode ser large ou small. Se o valor for large, somente os ECS I3 serão suportados. num: indica o número de partições no disco. size: indica a capacidade, na unidade de GB, do disco usado pelo usuário convidado. Se o valor da spec for large, o valor desse parâmetro será o tamanho de um único disco anexado ao ECS. Se o valor da spec for small, o valor deste parâmetro será 1/4 ou 1/2 da especificação. safeFormat: indica se os discos locais do ECS estão formatados de forma segura. Se o valor for True, somente os ECS I3 serão suportados. 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. Se o valor do parâmetro for FusionCompute, o ECS usará virtualização Xen. Se o valor do parâmetro for CloudCompute, o ECS usa virtualização KVM. 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: normal: indica o uso comercial normal do sabor. abandon: indica que o sabor foi cancelado (não exibido). sellout: indica que o sabor foi esgotado. obt: indica que o sabor está em teste beta aberto (OBT). obt_sellout: indica que os recursos OBT estão esgotados. promotion: indica o sabor recomendado (uso comercial, que é semelhante ao normal).
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: cond:operation:status: abandonar cond:operation:az: az0(normal), az1(vendido), az2(obt), az3(normal) 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. Unidade: Mbit/s. Se uma largura de banda estiver na unidade de Gbit/s, ela deve ser dividida por 1000.
quota:min_rate	String	Especificada a largura de banda assegurada. Unidade: Mbit/s. Se uma largura de banda estiver na unidade de Gbit/s, ela deve ser dividida por 1000.
quota:max_pps	String	Especifica o PPS máximo da intranet. Unidade: número. Se um valor estiver na unidade de 10000, deve ser dividido por 10000.
cond:operation:charge:stop	String	Especifica se as taxas são cobradas para um ECS interrompido. Sem taxas por padrão charge free
cond:operation:charge	String	Especifica um tipo de faturamento. Ambos os tipos de faturamento são suportados se esse parâmetro não estiver definido. Anual/Mensal Cobrança por uso
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. Equivalente a abandon se este parâmetro não estiver definido. normal: indica o uso comercial do sabor. abandon: indica que o sabor foi encerrado. sellout: indica que o sabor foi vendido. obt: indica que o sabor está na fase OBT (não suportado atualmente). private: indica que o sabor é privado, que está disponível apenas para usuários especificados (não suportado atualmente). test: indica que o sabor está em fase de teste gratuito (não suportado atualmente). promotion: indica que o sabor é recomendado.
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. Os recursos de disco são suportados. Se esse parâmetro não for definido, a configuração padrão no console será usada. scsi: indica que SCSI é suportado. localdisk: indica que os discos locais são suportados. ib: indica que o IB é suportado.
cond:compute:live_resizable	String	Especifica restrições de computação. Se o valor deste parâmetro for true, a expansão de capacidade online é suportada. Se esse parâmetro não existir ou seu valor estiver definido como false, a expansão de capacidade on-line não será suportada.
cond:compute	String	Especifica restrições de computação. autorecovery: indica que a recuperação automática é suportada. Se este parâmetro não existir, a recuperação automática não é suportada.
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.

**Tabela 7** **attachableQuantity** descrição do campo
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"
            }
        }
    ]
}