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 variantes de ECS de destino para os quais uma variante pode ser alterado
Atualizado em 2022-11-08 GMT+08:00

Consulta de variantes de ECS de destino para os quais uma variante pode ser alterado

Função

Um sabor ECS não pode ser alterado para determinados sabores. Essa API é usada para consultar as variações de destino para as quais uma variação de ECS especificada pode ser alterada.

URI

GET /v1/{project_id}/cloudservers/resize_flavors?instance_uuid={instance_uuid}&source_flavor_id={source_flavor_id}&source_flavor_name={source_flavor_name}

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.

Um dos parâmetros de instance_uuid, source_flavor_id, e source_flavor_name deve ser configurado. Se vários parâmetros estiverem configurados, o sistema processará os parâmetros instance_uuid, source_flavor_id, e source_flavor_name em ordem decrescente por padrão.

Se instance_uuid for usado para consultar as variações para as quais podem ser alteradas, somente as variações que suportam a imagem com base na qual o ECS de destino é criado serão retornadas. A razão é a seguinte: Imagens dependem de variantes. Se um ECS for criado usando uma imagem pública, a API filtra as variações suportadas pela imagem.

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

Tabela 2 Parâmetros de consulta

Parâmetro

Obrigatório

Tipo

Descrição

instance_uuid

Não

String

Especifica a ID do ECS de destino no formato UUID.

source_flavor_id

Não

String

Especifica o ID de sabor de origem.

source_flavor_name

Não

String

Especifica o nome do sabor de origem.

sort_key

Não

String

Indica o campo para classificação.

Opções:

  • flavorid: indica o ID do sabor. O valor padrão é flavorid.
  • name: indica o nome do sabor.
  • memory_mb: indica o tamanho da memória.
  • vcpus: indica o número de vCPUs.
  • root_gb: indica o tamanho do disco do sistema.

sort_dir

Não

String

Especifica a ordenação ascendente (asc) ou descendente (desc).

Opções:

  • asc: indica a ordem crescente.
  • desc: indica a ordem decrescente.

limit

Não

Integer

Especifica o número máximo de sabores que podem ser exibidos em uma página. O valor padrão é 1,000.

marker

Não

String

Especifica o ID do último sabor em uma página como o marcador de paginação.

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 o ID de variante do ECS.

name

String

Especifica o nome do variante ECS.

vcpus

String

Especifica o número das vCPU na variante ECS.

ram

Integer

Especifica o tamanho da memória (MB) na variante ECS.

disk

String

Especifica o tamanho do disco do sistema na variante ECS.

Este parâmetro não foi utilizado. O valor padrão é 0.

swap

String

Especifica o tamanho da partição de troca exigido pela variante 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 ECS foi desativada. Este é um atributo estendido.

Este parâmetro não foi utilizado. O valor padrão é false.

rxtx_factor

Float

Especifica a proporção entre a largura de banda de rede disponível e a largura de banda de hardware de rede do ECS.

Este parâmetro não foi utilizado. O valor padrão é 1.

rxtx_quota

String

Especifica as restrições de software da largura de banda da rede que pode ser usada 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 pode ser usada 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 o link de atalho da variação ECS.

Para mais detalhes, consulte Tabela 5.

extra_specs

Object

Especifica o campo estendido das especificações do ECS.

Para mais detalhes, consulte Tabela 6.

instance_quota

Object

Este é um parâmetro reservado.

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.

type

String

Especifica o tipo de link de atalho. Este parâmetro não foi utilizado. O valor padrão é null.

Exemplo de solicitação

GET https://{endpoint}/v1/{project_id}/cloudservers/resize_flavors?source_flavor_id=c3.xlarge.2

Exemplo de resposta

{
    "flavors": [
        {
            "id": "c3.15xlarge.2",
            "name": "c3.15xlarge.2",
            "vcpus": "60",
            "ram": 131072,
            "disk": "0",
            "swap": "",
            "links": [
                {
                    "rel": "self",
                    "href": "https://ecs.region.xxx.com/v1.0/743b4c0428d94531b9f2add666642e6b/flavors/c3.15xlarge.2",
                    "type": null
                },
                {
                    "rel": "bookmark",
                    "href": "https://ecs.region.xxx.com/743b4c0428d94531b9f2add666642e6b/flavors/c3.15xlarge.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,
            "extra_specs": {
                "ecs:virtualization_env_types": "CloudCompute",
                "ecs:generation": "c3",
                "ecs:performancetype": "computingv3",
                "resource_type": "IOoptimizedC3_2"
             }
        }
    ]
}

Valores retornados

Consulte Valores retornados para solicitações gerais.

Códigos de erro

Consulte Códigos de erro.