Querying Product Flavors

Function

This API is used to query the product flavor (parameter spec_code) required for configuring a new DCS instance. If no search criterion is specified, all product specifications will be queried by default.

Calling Method

For details, see Calling APIs.

URI

GET /v2/{project_id}/flavors

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID. For details, see Obtaining a Project ID.

**Table 2** Query Parameters
Parameter	Mandatory	Type	Description
spec_code	No	String	Product flavor.
cache_mode	No	String	DCS instance type. Options: single: single-node ha: master/standby cluster: Redis Cluster proxy: Proxy Cluster ha_rw_split: read/write splitting
engine	No	String	Cache engine. Options: Redis Memcached
engine_version	No	String	Cache engine version. If the cache engine is Redis, the options are as follows: 4.0 5.0 7.0
cpu_type	No	String	CPU architecture. The options are as follows: x86_64: x86 architecture aarch64: Arm architecture
capacity	No	String	Cache capacity (GB). For a single-node or master/standby DCS Redis 4.0/5.0/6.0/7.0 instance, the value can be 0.125, 0.25, 0.5, 1, 2, 4, 8, 16, 24, 32, 48, or 64. For a cluster DCS Redis 4.0 or later instance, the value can be 4, 8, 16, 24, 32, 48, 64, 96, 128, 192, 256, 384, 512, 768, or 1024. For a read/write splitting DCS Redis 4.0/5.0 instance, the value can be 8, 16, 32, or 64. For a single-node or master/standby DCS Memcached instance, the value can be 2, 4, 8, 16, 32, or 64.
spec_type	No	String	Product flavor type: instance: instance flavor node: node flavor

Request Parameters

None

Response Parameters

Status code: 200

**Table 3** Response body parameters
Parameter	Type	Description
flavors	Array of FlavorsItems objects	Product flavor details.
billing_factor	String	Billing mode. This parameter is an internal parameter of the service and does not need to be concerned.
spec_type	String	Product flavor type: instance: instance flavor node: node flavor

**Table 4** FlavorsItems
Parameter	Type	Description
spec_code	String	Product flavor.
cloud_service_type_code	String	Code of the cloud service type.
cloud_resource_type_code	String	Code of the cloud resource type.
cache_mode	String	DCS instance type. Options: single: single-node ha: master/standby cluster: Redis Cluster proxy: Proxy Cluster ha_rw_split: read/write splitting
engine	String	Cache engine.
engine_version	String	Cache engine version. If the cache engine is Redis, the value can be 4.0, 5.0, or 6.0.
product_type	String	Edition of DCS for Redis. Value: generic: basic edition
cpu_type	String	CPU architecture. The options are as follows: x86_64: x86 architecture aarch64: Arm architecture
storage_type	String	Storage type. Currently, only the following value is supported: DRAM: in-memory storage
capacity	Array of strings	Cache capacity (GB).
billing_mode	Array of strings	Billing mode. The value can be: Hourly: pay-per-use
tenant_ip_count	Integer	Number of tenant IP addresses.
pricing_type	String	Pricing type. The options are as follows: tier: Tiered pricing. One flavor corresponds to multiple capacity options. normal: One flavor corresponds to one capacity option.
is_dec	Boolean	Whether Dedicated Cloud (DeC) is supported.
dec	Boolean	Whether to support Redis 3.0 Dedicated Cloud (DeC).
attrs	Array of AttrsObject objects	Other information about the flavor.
flavors_available_zones	Array of FlavorAzObject objects	AZs where there are available resources.
replica_count	Integer	Replicas.
inquery_spec_code	String	Product flavor code. This parameter is an internal parameter of the service and does not need to be concerned.
billing_factor	String	Billing mode. This parameter is an internal parameter of the service and does not need to be concerned.

**Table 5** AttrsObject
Parameter	Type	Description
capacity	String	Cache capacity (GB).
name	String	Additional information items. The options are as follows: sharding_num: Number of shards supported by the flavor. proxy_num: Number of proxies supported by Proxy Cluster instances of the specified flavor. If the instance is not a Proxy Cluster instance, the value of this parameter is 0. db_number: Number of DBs of the flavor. max_memory: Maximum available memory. max_connections: Maximum number of connections supported by the flavor. max_clients: Maximum number of clients supported by the flavor, which is usually equal to the maximum number of connections. max_bandwidth: Maximum bandwidth supported by the flavor. max_in_bandwidth: Maximum inbound bandwidth supported by the flavor, which is usually equal to the maximum bandwidth.
value	String	Additional information value.

**Table 6** FlavorAzObject
Parameter	Type	Description
capacity	String	Cache capacity (value).
unit	String	Cache capacity (unit).
available_zones	Array of strings	AZ information.
az_codes	Array of strings	AZs where there are available resources.

Status code: 400

**Table 7** Response body parameters
Parameter	Type	Description
error_msg	String	Error message.
error_code	String	Error code.
error_ext_msg	String	Extended error information. This parameter is not used currently and is set to null.

Status code: 401

**Table 8** Response body parameters
Parameter	Type	Description
error_msg	String	Error message.
error_code	String	Error code.
error_ext_msg	String	Extended error information. This parameter is not used currently and is set to null.

Status code: 403

**Table 9** Response body parameters
Parameter	Type	Description
error_msg	String	Error message.
error_code	String	Error code.
error_ext_msg	String	Extended error information. This parameter is not used currently and is set to null.

Status code: 404

**Table 10** Response body parameters
Parameter	Type	Description
error_msg	String	Error message.
error_code	String	Error code.
error_ext_msg	String	Extended error information. This parameter is not used currently and is set to null.

Status code: 500

**Table 11** Response body parameters
Parameter	Type	Description
error_msg	String	Error message.
error_code	String	Error code.
error_ext_msg	String	Extended error information. This parameter is not used currently and is set to null.

Example Requests

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

Example Responses

Status code: 200

Product flavors queried successfully.

{
  "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",
      "unit" : "GB",
      "available_zones" : [ "d539378ec1324c85b76fefa3f7071458" ],
      "az_codes" : [ "region01" ]
    } ],
    "replica_count" : 1,
    "inquery_spec_code" : "redis.single.au1.large.1",
    "billing_factor" : "Duration"
  } ]
}

Status code: 400

Invalid request.

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

Status code: 401

Invalid authentication information.

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

Status code: 403

The request is rejected.

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

Status code: 404

The requested resource is not found.

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

Status code: 500

Internal service error.

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

Status Codes

Status Code	Description
200	Product flavors queried successfully.
400	Invalid request.
401	Invalid authentication information.
403	The request is rejected.
404	The requested resource is not found.
500	Internal service error.