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/ Distributed Cache Service/ Referência de API/ API V2/ Outras API/ Consulta de variantes do produto

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

Ver PDF

Consulta de variantes do produto

Função

Essa API é usada para consultar a variação do produto (parâmetro spec_code) necessária para configurar uma nova instância de DCS. Se nenhum critério de pesquisa for especificado, todas as especificações do produto serão consultadas por padrão.

URI

GET /v2/{project_id}/flavors

**Tabela 1** Parâmetros de caminho
Parâmetro	Obrigatório	Tipo	Descrição
project_id	Sim	String	ID do projeto.

**Tabela 2** Parâmetros de consulta
Parâmetro	Obrigatório	Tipo	Descrição
spec_code	Não	String	Variante de produto.
cache_mode	Não	String	Tipos de instância do DCS. As opções são as seguintes: single: nó único ha: principal/em espera cluster: Cluster do Redis proxy: Cluster de proxy - ha_rw_split: divisão de leitura/gravação
engine	Não	String	Mecanismo de cache. As opções são as seguintes: Redis Memcached
engine_version	Não	String	Versão do mecanismo de cache. Se o mecanismo de cache for o Redis, as opções serão as seguintes: 3.0 4.0 5.0
cpu_type	Não	String	Arquitetura da CPU. As opções são as seguintes: x86_64: arquitetura x86 aarch64: Arquitectura do braço Valores de enumeração: x86_64 aarch64
capacity	Não	String	Capacidade de cache (GB). Para uma instância do DCS Redis 3.0 de nó único ou principal/em espera, o valor pode ser 2, 4, 8, 16, 32, ou 64. Para uma instância do DCS Redis 3.0 de cluster de proxy, o valor pode ser 64, 128, 256, 512, ou 1024. Para uma instância do DCS Redis 4.0 ou 5.0 de nó único ou principal/em espera, o valor pode ser 0.125, 0.25, 0.5, 1, 2, 4, 8, 16, 32, ou 64. Para uma instância do Cluster do Redis DCS Redis 4.0 ou 5.0, o valor pode ser 24, 32, 48, 64, 96, 128, 192, 256, 384, 512, 768, ou **1024. Para uma instância de Memcached DCS de nó único ou principal/em espera, o valor pode ser 2, 4, 8, 16, 32, ou 64.

Parâmetros de solicitação

Nenhum

Parâmetros de resposta

Código de estado: 200

**Tabela 3** Parâmetros do corpo de resposta
Parâmetro	Tipo	Descrição
flavors	Array of FlavorsItems objects	Detalhes do sabor do produto.

**Tabela 4** FlavorsItems
Parâmetro	Tipo	Descrição
spec_code	String	Variante de produto.
cloud_service_type_code	String	Código do tipo de serviço de nuvem.
cloud_resource_type_code	String	Código do tipo de recurso de nuvem.
cache_mode	String	Tipos de instância do DCS. As opções são as seguintes: single: nó único ha: principal/em espera cluster: Cluster do Redis proxy: Cluster de proxy
engine	String	Mecanismo de cache.
engine_version	String	Versão do mecanismo de cache. Se o mecanismo de cache for Redis, o valor poderá ser 4.0, ou 5.0.
product_type	String	Edição da DCS para Redis. Atualmente, apenas o seguinte valor é suportado: generic: padrão
cpu_type	String	Arquitetura da CPU. As opções são as seguintes: x86_64: arquitetura x86 aarch64: Arquitectura do braço
storage_type	String	Tipo de armazenamento. Atualmente, apenas o seguinte valor é suportado: DRAM: armazenamento na memória
capacity	Array of strings	Capacidade de cache (GB).
billing_mode	Array of strings	Modo de cobrança. O valor pode ser: Hourly: pay-per-use
tenant_ip_count	Integer	Número de endereços IP do locatário.
pricing_type	String	Tipo de preço. As opções são as seguintes: tier: Preço por nível. Um sabor corresponde a várias opções de capacidade. normal: Um sabor corresponde a uma opção de capacidade.
is_dec	Boolean	Se o Dedicated Cloud (DeC) é suportado.
attrs	Array of AttrsObject objects	Outras informações sobre o sabor.
flavors_available_zones	Array of FlavorAzObject objects	Os AZ onde há recursos disponíveis.

**Tabela 5** AttrsObject
Parâmetro	Tipo	Descrição
capacity	String	Capacidade de cache (GB).
name	String	Itens de informações adicionais. As opções são as seguintes: sharding_num: Número de estilhaços suportados pela sabor. proxy_num: Número de proxies suportados pelas instâncias de cluster de proxy do sabor especificado. Se a instância não for uma instância de Cluster de Proxy, o valor deste parâmetro é 0. db_number: Número de DBs do sabor. max_memory: Memória máxima disponível. max_connections: Número máximo de conexões suportadas pelo sabor. max_clients: Número máximo de clientes suportados pelo sabor, que geralmente é igual ao número máximo de conexões. max_bandwidth: Largura de banda máxima suportada pelo sabor. max_in_bandwidth: Largura de banda máxima de entrada suportada pelo sabor, que geralmente é igual à largura de banda máxima.
value	String	Valor adicional da informação.

**Tabela 6** FlavorAzObject
Parâmetro	Tipo	Descrição
capacity	String	Capacidade de cache (GB).
az_codes	Array of strings	Os AZ onde há recursos disponíveis.

Código de estado: 400

**Tabela 7** Parâmetros do corpo de resposta
Parâmetro	Tipo	Descrição
error_msg	String	Mensagem de erro. Máximo: 1024
error_code	String	Código de erro. Máximo: 9
error_ext_msg	String	Informações de erro estendidas. Este parâmetro não é usado atualmente e está definido como nulo. Máximo: 1024

Código de estado: 401

**Tabela 8** Parâmetros do corpo de resposta
Parâmetro	Tipo	Descrição
error_msg	String	Mensagem de erro. Máximo: 1024
error_code	String	Código de erro. Máximo: 9
error_ext_msg	String	Informações de erro estendidas. Este parâmetro não é usado atualmente e está definido como nulo. Máximo: 1024

Código de estado: 403

**Tabela 9** Parâmetros do corpo de resposta
Parâmetro	Tipo	Descrição
error_msg	String	Mensagem de erro. Máximo: 1024
error_code	String	Código de erro. Máximo: 9
error_ext_msg	String	Informações de erro estendidas. Este parâmetro não é usado atualmente e está definido como nulo. Máximo: 1024

Código de estado: 404

**Tabela 10** Parâmetros do corpo de resposta
Parâmetro	Tipo	Descrição
error_msg	String	Mensagem de erro. Máximo: 1024
error_code	String	Código de erro. Máximo: 9
error_ext_msg	String	Informações de erro estendidas. Este parâmetro não é usado atualmente e está definido como nulo. Máximo: 1024

Código de estado: 500

**Tabela 11** Parâmetros do corpo de resposta
Parâmetro	Tipo	Descrição
error_msg	String	Mensagem de erro. Máximo: 1024
error_code	String	Código de erro. Máximo: 9
error_ext_msg	String	Informações de erro estendidas. Este parâmetro não é usado atualmente e está definido como nulo. Máximo: 1024

Exemplos de solicitações

GET https://{dcs_endpoint}/v2/flavors?cache_mode={cache_mode}&engine={engine}&engine_version={engine_version}&cpu_type={cpu_type}&capacity={capacity}

Exemplo de respostas

Código de estado: 200

Sabores de produtos consultados com sucesso.

{
  "flavors" : [ {
    "spec_code" : "redis.single.au1.large.1",
    "cloud_service_type_code" : "hws.resource.type.dcs3",
    "cloud_resource_type_code" : "hws.resource.type.dcs3",
    "cache_mode" : "single",
    "engine" : "redis",
    "engine_version" : "4.0;5.0",
    "product_type" : "generic",
    "cpu_type" : "aarch64",
    "storage_type" : "DRAM",
    "capacity" : [ 1 ],
    "billing_mode" : [ "Hourly" ],
    "tenant_ip_count" : 1,
    "pricing_type" : "normal",
    "is_dec" : false,
    "attrs" : [ {
      "capacity" : 1,
      "name" : "max_memory",
      "value" : 1
    }, {
      "capacity" : 1,
      "name" : "max_connections",
      "value" : 10000
    }, {
      "capacity" : 1,
      "name" : "sharding_num",
      "value" : 1
    }, {
      "capacity" : 1,
      "name" : "proxy_num",
      "value" : 0
    }, {
      "capacity" : 1,
      "name" : "db_number",
      "value" : 256
    }, {
      "capacity" : 1,
      "name" : "max_clients",
      "value" : 10000
    }, {
      "capacity" : 1,
      "name" : "max_bandwidth",
      "value" : 80
    } ],
    "flavors_available_zones" : [ {
      "capacity" : 1,
      "az_code" : [ "cn-north-7c" ]
    } ]
  } ]
}

Código de estado: 400

Pedido inválido.

{
  "error_code" : "DCS.1004",
  "error_msg" : "Project ID does not match the token."
}

Código de estado: 401

Informações de autenticação inválidas.

{
  "error_code" : "DCS.1001",
  "error_msg" : "Invalid token."
}

Código de estado: 403

O pedido é rejeitado.

{
  "error_code" : "DCS.2003",
  "error_msg" : "This role does not have the permission to perform this operation."
}

Código de estado: 404

O recurso solicitado não foi encontrado.

{
  "error_code" : "DCS.4001",
  "error_msg" : "The requested URL does not exist."
}

Código de estado: 500

Erro de serviço interno.

{
  "error_code" : "DCS.5000",
  "error_msg" : "Internal service error."
}

Códigos de status

Código de status	Descrição
200	Sabores de produtos consultados com sucesso.
400	Pedido inválido.
401	Informações de autenticação inválidas.
403	O pedido é rejeitado.
404	O recurso solicitado não foi encontrado.
500	Erro de serviço interno.