# 查询产品规格列表
#### 功能介绍
在创建缓存实例时，需要配置订购的产品ID（即product_id），可通过该接口查询产品规格。例如，要订购按需计费、实例类型为Redis3.0的主备实例，可从接口响应消息中，查找charging_type字段为Hourly、spec_code字段为dcs.master_standby的记录对应的product_id，该字段的值即是创建缓存实例时需要配置的产品ID。
#### **URI**
GET /v1.0/products
#### **请求消息**
**请求参数**
无。
**请求示例**
无。
#### **响应消息**
**响应参数**
参数说明见[表1]。
 表1参数说明 
| 参数        | 类型     | 说明  |
|:---|:---|:---|
| products | Array | 产品列表。 |
   
表2products参数说明 
| 参数                        | 类型       | 备注                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
|:---|:---|:---|
| product_id                 | String   | DCS服务对外销售的产品ID。 参数取值格式为：spec_code+"-" + 计费模式缩写，计费模式缩写取值范围有：h、m、y。其中，h表示计费模式为按需；m表示计费模式为包月；y表示计费模式为包年。 例如：redis.single.au1.large.1-h，表示规格redis.single.au1.large.1的按需计费产品ID。 说明： 在查询产品规格中获取product_id时，请务必确保获取的product_id对应的计费模式和您选择的计费模式一致。例如，要订购按需计费、实例类型为Redis3.0的主备实例，可从接口响应消息中，查找charging_type字段为Hourly、spec_code字段为dcs.master_standby的记录对应的product_id。                                         |
| spec_code                 | String | DCS的产品规格编码。 - dcs.single_node  - dcs.master_standby  - dcs.cluster                                                                                                                                                                              |
| cache_mode                | String   | 缓存实例类型。取值范围如下： - single：表示单机  - ha：表示主备实例  - cluster：表示集群  - proxy：表示Proxy集群  - ha_rw_split：表示读写分离   |
| product_type             | String    | Redis缓存实例的产品类型。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| cpu_type                | String  | CPU架构类型。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| storage_type              | String  | 存储类型。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| details                | Array    | 规格详细描述，具体参数，请参考[表3]。                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| engine                    | String   | 缓存引擎类型。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| engine_versions          | String   | 支持的引擎版本号。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| spec_details            | String   | 产品的规格大小。具体以查询结果为准。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| spec_details2             | String     | DCS的规格详细信息，如最大连接数和最大使用内存等。                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| charging_type             | String    | 计费类型，取值为：Yearly、Monthly、Hourly。                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| price                    | Double     | 价格。（已废弃，无实际意义，请不要使用。）                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| currency                   | String    | 货币单位。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| prod_type                | String  | 产品类型，取值为instance或者obs_space。                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| cloud_service_type_code   | String     | 云服务类型编码。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| cloud_resource_type_code | String | 云资源类型编码。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| flavors                  | Array     | 有资源的可用区，具体参数，请参考[表4]。                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| billing_factor            | String    | 计费因子。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
   
 表3details参数说明 
| 参数               | 类型      | 备注                                        |
|:---|:---|:---|
| 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数量。                               |
   
 表4flavors参数说明 
| 参数              | 类型     | 备注       |
|:---|:---|:---|
| capacity       | String | 缓存实例的内存规格。 |
| unit            | String  | 容量单位    |
| available_zones | Array  | 可用区ID。 |
   
**响应示例**
```
{
"product_id": "dcs.master_standby-h",
"spec_code": "dcs.master_standby",
"cache_mode": "ha",
"product_type": "generic",
"cpu_type": "x86_64",
"storage_type": "DRAM",
"details": {
"capacity": 2,
"max_memory": 1.5,
"max_connections": 10000,
"max_clients": 5000,
"max_bandwidth": 512,
"max_in_bandwidth": 42,
"tenant_ip_count": 3,
"sharding_num": 1,
"proxy_num": 0,
"db_number": 256
},
"engine": "redis",
"engine_versions": "3.0",
"spec_details": "[{\"mem\":\"2,4,8,16,32,64\"}]",
"spec_details2": "[{\"capacity\":2,\"max_memory\":1.5,\"max_connections\":10000,\"max_clients\":5000,\"max_bandwidth\":512,\"max_in_bandwidth\":42,\"tenant_ip_count\":3,\"sharding_num\":1,\"proxy_num\":0,\"db_number\":256},{\"capacity\":4,\"max_memory\":3.2,\"max_connections\":10000,\"max_clients\":5000,\"max_bandwidth\":1536,\"max_in_bandwidth\":64,\"tenant_ip_count\":3,\"sharding_num\":1,\"proxy_num\":0,\"db_number\":256},{\"capacity\":8,\"max_memory\":6.4,\"max_connections\":10000,\"max_clients\":5000,\"max_bandwidth\":1536,\"max_in_bandwidth\":64,\"tenant_ip_count\":3,\"sharding_num\":1,\"proxy_num\":0,\"db_number\":256},{\"capacity\":16,\"max_memory\":12.8,\"max_connections\":10000,\"max_clients\":5000,\"max_bandwidth\":3072,\"max_in_bandwidth\":85,\"tenant_ip_count\":3,\"sharding_num\":1,\"proxy_num\":0,\"db_number\":256},{\"capacity\":32,\"max_memory\":25.6,\"max_connections\":10000,\"max_clients\":5000,\"max_bandwidth\":3072,\"max_in_bandwidth\":85,\"tenant_ip_count\":3,\"sharding_num\":1,\"proxy_num\":0,\"db_number\":256},{\"capacity\":64,\"max_memory\":51.2,\"max_connections\":12000,\"max_clients\":5000,\"max_bandwidth\":5120,\"max_in_bandwidth\":128,\"tenant_ip_count\":3,\"sharding_num\":1,\"proxy_num\":0,\"db_number\":256}]",
"charging_type": "Hourly",
"price": 0.0,
"currency": "",
"prod_type": "instance",
"cloud_service_type_code": "hws.service.type.dcs",
"cloud_resource_type_code": "hws.resource.type.dcs",
"flavors": [{
"capacity": "2",
"unit": "GB",
"available_zones": ["882f6e449e3245dbb8c1c0fafa494c89",
"ae04cf9d61544df3806a3feeb401b204",
"d573142f24894ef3bd3664de068b44b0"]
},
{
"capacity": "4",
"unit": "GB",
"available_zones": ["882f6e449e3245dbb8c1c0fafa494c89",
"ae04cf9d61544df3806a3feeb401b204",
"d573142f24894ef3bd3664de068b44b0"]
},
{
"capacity": "8",
"unit": "GB",
"available_zones": ["882f6e449e3245dbb8c1c0fafa494c89",
"ae04cf9d61544df3806a3feeb401b204",
"d573142f24894ef3bd3664de068b44b0"]
},
{
"capacity": "16",
"unit": "GB",
"available_zones": ["882f6e449e3245dbb8c1c0fafa494c89",
"ae04cf9d61544df3806a3feeb401b204",
"d573142f24894ef3bd3664de068b44b0"]
},
{
"capacity": "32",
"unit": "GB",
"available_zones": ["882f6e449e3245dbb8c1c0fafa494c89",
"ae04cf9d61544df3806a3feeb401b204",
"d573142f24894ef3bd3664de068b44b0"]
},
{
"capacity": "64",
"unit": "GB",
"available_zones": ["882f6e449e3245dbb8c1c0fafa494c89",
"ae04cf9d61544df3806a3feeb401b204",
"d573142f24894ef3bd3664de068b44b0"]
}],
"billing_factor": "Duration"
}
```
#### **状态码**
操作成功的状态码如[表5]所示，其他响应见[表1](https://support.huaweicloud.com/api-dcs/dcs-api-0312043.html#dcs-api-0312043__table5210141351517)。
 表5状态码 
| 状态码 | 描述         |
|:---|:---|
| 200     | 查询规格列表成功。 |
   
