更新时间:2023-12-13 GMT+08:00

查询产品规格列表

功能介绍

在创建缓存实例时,需要配置订购的产品ID(即product_id),可通过该接口查询产品规格。

URI

GET /v1.0/products

请求消息

请求参数

无。

请求示例

无。

响应消息

响应参数

参数说明见表1
表1 参数说明

参数

类型

说明

products

Array

产品列表。

表2 products参数说明

参数

类型

备注

product_id

String

DCS服务对外销售的产品ID。

spec_code

String

DCS的产品规格编码。

可通过登录分布式缓存服务管理控制台,在实例创建页面的“实例规格”区域,从“规格名称”列获取相应实例的产品规格编码。部分举例如下:

Redis 3.0:

  • dcs.single_node
  • dcs.master_standby
  • dcs.cluster
Memcached:
  • dcs.memcached.single_node
  • dcs.memcached.master_standby

Redis 4.0/5.0:

  • redis.ha.xu1.tiny.r4.512
  • redis.ha.xu1.tiny.r2.128
  • redis.cluster.xu1.large.r5.4

cache_mode

String

缓存实例类型。取值范围如下:

  • single:表示单机
  • ha:表示主备实例
  • cluster:表示集群
  • proxy:表示Proxy集群

product_type

String

Redis缓存实例的产品类型。

cpu_type

String

CPU架构类型。

storage_type

String

存储类型。

details

Array of Object

规格详细描述,具体参数,请参考表3

engine

String

缓存引擎类型。

engine_versions

String

支持的引擎版本号。

spec_details

String

产品的规格大小。具体以查询结果为准。

spec_details2

String

DCS的规格详细信息,如最大连接数和最大使用内存等。

charging_type

String

计费类型,取值为:Hourly。

price

double

价格。(已废弃,无实际意义,请不要使用。)

currency

String

货币单位。

prod_type

String

产品类型,取值为instance或者obs_space。

cloud_service_type_code

String

云服务类型编码。

cloud_resource_type_code

String

云资源类型编码。

flavors

Array

有资源的可用区,具体参数,请参考表4

表3 details参数说明

参数

类型

备注

capacity

String

缓存实例的内存规格。

max_bandwidth

String

该规格支持的最大带宽。

max_clients

String

该规格支持的最大客户端数,一般等于最大连接数。

max_connections

String

该规格支持的最大连接数。

max_in_bandwidth

String

该规格支持的最大接入带宽,一般等于最大带宽。

max_memory

String

实际可使用的最大内存。

tenant_ip_count

String

该规格实例对应的租户侧IP数量。

sharding_num

String

该规格实例支持的分片数。

proxy_num

String

该规格Proxy实例支持的Proxy节点数量。如果不是Proxy实例,该参数为0。

db_number

String

该规格实例的DB数量。

表4 flavors参数说明

参数

类型

备注

capacity

String

缓存实例的内存规格。

unit

String

容量单位。

available_zones

Array

可用区ID。

响应示例

{
    "products": [
       {
            "details": {
                "capacity": 64,
                "max_memory": 64,
                "max_connections": 20000,
                "max_clients": 80000,
                "max_bandwidth": 2000,
                "max_in_bandwidth": 600,
                "proc_num": 8
            },
            "engine": "redis",
            "price": 0.04,
            "currency": "1",
            "flavors": [
                {
                    "capacity": "64",
                    "unit": "GB",
                    "available_zones": [
                        "ae04cf9d61544df3806a3feeb401b204",
                        "882f6e449e3245dbb8c1c0fafa494c89"
                    ]
                },
                {
                    "capacity": "128",
                    "unit": "GB",
                    "available_zones": [
                        "ae04cf9d61544df3806a3feeb401b204",
                        "882f6e449e3245dbb8c1c0fafa494c89"
                    ]
                },
                {
                    "capacity": "256",
                    "unit": "GB",
                    "available_zones": [
                        "ae04cf9d61544df3806a3feeb401b204",
                        "882f6e449e3245dbb8c1c0fafa494c89"
                    ]
                }
            ],
            "product_id": "00301-30112-0--0",
            "spec_code": "dcs.cluster",
            "cache_mode": "cluster",
            "product_type": "generic",
            "cpu_type": "x86_64",
            "storage_type": "DRAM",
            "engine_versions": "3.0",
            "spec_details": "[{\"mem\":\"64,128,256\"}]",
            "spec_details2": "[{\"capacity\": 64,\"max_memory\": 64,\"max_connections\": 20000,\"max_clients\":80000,\"max_bandwidth\": 2000,\"max_in_bandwidth\": 600,\"proc_num\":8},{\"capacity\": 128,\"max_memory\": 128,\"max_connections\": 20000,\"max_clients\":160000,\"max_bandwidth\": 2000,\"max_in_bandwidth\": 600,\"proc_num\":16},{\"capacity\": 256,\"max_memory\": 256,\"max_connections\": 20000,\"max_clients\":160000,\"max_bandwidth\": 2000,\"max_in_bandwidth\": 600,\"proc_num\":32},{\"capacity\": 512,\"max_memory\": 512,\"max_connections\": 20000,\"max_clients\":160000,\"max_bandwidth\": 2000,\"max_in_bandwidth\": 600,\"proc_num\":64},{\"capacity\": 1024,\"max_memory\": 1024,\"max_connections\": 20000,\"max_clients\":160000,\"max_bandwidth\": 2000,\"max_in_bandwidth\": 600,\"proc_num\":128}]",
            "charging_type": "Hourly",
            "prod_type": "instance",
            "cloud_service_type_code": "XXXX",
            "cloud_resource_type_code": "XXXX"
        },
}

状态码

操作成功的状态码如表5所示,其他响应见表1

表5 状态码

状态码

描述

200

查询规格列表成功。