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
Compartir

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.

Códigos de error

Consulte Códigos de error.

Tema principal: Otras APIs