Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.

Centro de ayuda> Distributed Cache Service> Referencia de la API> API V2> Otras APIs> Consulta de variantes de productos

Actualización más reciente 2022-11-09 GMT+08:00

Ver PDF

Consulta de variantes de productos

Función

Esta API se utiliza para consultar el tipo de producto (parámetro spec_code) necesario para configurar una nueva instancia de DCS. Si no se especifica ningún criterio de búsqueda, todas las especificaciones del producto se consultarán de forma predeterminada.

URI

GET /v2/{project_id}/flavors

**Tabla 1** Parámetros de path
Parámetro	Obligatorio	Tipo	Descripción
project_id	Sí	String	ID del proyecto.

**Tabla 2** Query Parameters
Parámetro	Obligatorio	Tipo	Descripción
spec_code	No	String	Variante del producto.
cache_mode	No	String	Tipo de instancia de DCS. Las opciones son las siguientes: single: nodo único ha: maestro/en espera cluster: Clúster en Redis proxy: Clúster de Proxy
engine	No	String	Motor de caché. Las opciones son las siguientes: Redis Memcached
engine_version	No	String	Versión del motor de caché. Si el motor de caché es Redis, las opciones son las siguientes: 3.0 4.0 5.0
cpu_type	No	String	Arquitectura de CPU. Las opciones son las siguientes: x86_64: arquitectura x86 aarch64: Arquitectura de brazo Valores de enumeración: x86_64 aarch64
capacity	No	String	Capacidad de caché (GB). Para una instancia de DCS Redis 3.0 de un solo nodo o maestro/en espera, el valor puede ser 2, 4, 8, 16, 32, o 64. Para una instancia de DCS Redis 3.0 de clúster proxy, el valor puede ser 64, 128, 256, 512, o 1024. Para una instancia DCS Redis 4.0 o 5.0 de nodo único o maestro/en espera, el valor puede ser 0.125, 0.25, 0.5, 1, 2, 4, 8, 16, 32, or 64. Para una instancia de Redis Cluster DCS Redis 4.0 o 5.0, el valor puede ser 24, 32, 48, 64, 96, 128, 192, 256, 384, 512, 768, o **1024. Para una instancia de DCS Memcached de un solo nodo o maestro/en espera, el valor puede ser 2, 4, 8, 16, 32, or 64.

Parámetros de solicitud

Ninguno

Parámetros de respuesta

Código de estado: 200

**Tabla 3** Parámetros de body de respuesta
Parámetro	Tipo	Descripción
flavors	Array of FlavorsItems objects	Detalles del variante del producto.

**Tabla 4** FlavorsItems
Parámetro	Tipo	Descripción
spec_code	String	Variante del producto.
cloud_service_type_code	String	Código del tipo de servicio en la nube.
cloud_resource_type_code	String	Código del tipo de recurso de nube.
cache_mode	String	Tipo de instancia de DCS. Las opciones son las siguientes: single: nodo único ha: maestro/en espera cluster: Clúster en Redis proxy: clúster de proxy
engine	String	Motor de caché.
engine_version	String	Versión del motor de caché. Si el motor de caché es Redis, el valor puede ser 4.0 o 5.0.
product_type	String	Edición de DCS para Redis. Actualmente, solo se admite el siguiente valor: generic: estándar
cpu_type	String	Arquitectura de CPU. Las opciones son las siguientes: x86_64: arquitectura x86 aarch64: Arquitectura de brazo
storage_type	String	Tipo de almacenamiento. Actualmente, solo se admite el siguiente valor: DRAM: almacenamiento en memoria
capacity	Array of strings	Capacidad de caché (GB).
billing_mode	Array of strings	Modo de facturación. El valor puede ser: Hourly: pago por uso
tenant_ip_count	Integer	Número de direcciones IP del inquilino.
pricing_type	String	Tipo de precio. Las opciones son las siguientes: tier: Precios por niveles. Un variante corresponde a múltiples opciones de capacidad. normal: Un variante corresponde a una opción de capacidad.
is_dec	Boolean	Si se admite Dedicated Cloud (DeC).
attrs	Array of AttrsObject objects	Otra información sobre el variante.
flavors_available_zones	Array of FlavorAzObject objects	Zonas de disponibilidad donde hay recursos disponibles.

**Tabla 5** AttrsObject
Parámetro	Tipo	Descripción
capacity	String	Capacidad de caché (GB).
name	String	Elementos de información adicional. Las opciones son las siguientes: sharding_num: Número de fragmentos admitidos por el variante. proxy_num: Número de proxies admitidos por instancias de clúster de proxy del tipo especificado. Si la instancia no es una instancia de clúster proxy, el valor de este parámetro es 0. db_number: Número de bases de datos del variante. max_memory: Memoria máxima disponible. max_connections: Número máximo de conexiones admitidas por el variante. max_clients: Número máximo de clientes admitidos por el variante, que suele ser igual al número máximo de conexiones. max_bandwidth: Ancho de banda máximo soportado por el variante. max_in_bandwidth: Ancho de banda entrante máximo soportado por el variante, que suele ser igual al ancho de banda máximo.
value	String	Valor de información adicional.

**Tabla 6** FlavorAzObject
Parámetro	Tipo	Descripción
capacity	String	Capacidad de caché (GB).
az_codes	Array of strings	Zonas de disponibilidad donde hay recursos disponibles.

Código de estado: 400

**Tabla 7** Parámetros de body de respuesta
Parámetro	Tipo	Descripción
error_msg	String	Mensaje de error. Máximo: 1024
error_code	String	Código de error. Máximo: 9
error_ext_msg	String	Información de error extendida. Este parámetro no se utiliza actualmente y se establece en null. Máximo: 1024

Código de estado: 401

**Tabla 8** Parámetros de body de respuesta
Parámetro	Tipo	Descripción
error_msg	String	Mensaje de error. Máximo: 1024
error_code	String	Código de error. Máximo: 9
error_ext_msg	String	Información de error extendida. Este parámetro no se utiliza actualmente y se establece en null. Máximo: 1024

Código de estado: 403

**Tabla 9** Parámetros de body de respuesta
Parámetro	Tipo	Descripción
error_msg	String	Mensaje de error. Máximo: 1024
error_code	String	Código de error. Máximo: 9
error_ext_msg	String	Información de error extendida. Este parámetro no se utiliza actualmente y se establece en null. Máximo: 1024

Código de estado: 404

**Tabla 10** Parámetros de body de respuesta
Parámetro	Tipo	Descripción
error_msg	String	Mensaje de error. Máximo: 1024
error_code	String	Código de error. Máximo: 9
error_ext_msg	String	Información de error extendida. Este parámetro no se utiliza actualmente y se establece en null. Máximo: 1024

Código de estado: 500

**Tabla 11** Parámetros de body de respuesta
Parámetro	Tipo	Descripción
error_msg	String	Mensaje de error. Máximo: 1024
error_code	String	Código de error. Máximo: 9
error_ext_msg	String	Información de error extendida. Este parámetro no se utiliza actualmente y se establece en null. Máximo: 1024

Solicitudes de ejemplo

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

Ejemplo de respuestas

Código de estado: 200

Los sabores del producto consultados con éxito.

{
  "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

Solicitud no válida.

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

Código de estado: 401

Información de autenticación no válida.

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

Código de estado: 403

La solicitud se rechaza.

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

Código de estado: 404

La página solicitada no se encuentra.

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

Código de estado: 500

Error interno del servicio.

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

Códigos de estado

Status Code	Descripción
200	Los sabores del producto consultados con éxito.
400	Solicitud no válida.
401	Información de autenticación no válida.
403	La solicitud se rechaza.
404	La página solicitada no se encuentra.
500	Error interno del servicio.