# 查询数据库规格（v3.1）
#### 功能介绍
查询数据库的规格信息。
- 调用接口前，您需要了解API [认证鉴权](https://support.huaweicloud.com/api-gaussdb/gaussdb_api_011.html)。
- 调用接口前，您需要提前获取到[地区和终端节点](https://developer.huaweicloud.com/endpoint)。
 
#### 调试
您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=GaussDBforopenGauss&api=ListDbFlavors)中调试该接口。
#### URI
GET /v3.1/{project_id}/flavors
表1参数说明 
| 名称         | 是否必选 | 参数类型    | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
|:---|:---|:---|:---|
| project_id | 是    | String  | **参数解释：** 租户在某一Region下的项目ID。 获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-gaussdb/gaussdb_api_196.html)。 **约束限制：** 不涉及。 **取值范围：** 只能由英文字母、数字组成，且长度为32个字符。 **默认取值**： 不涉及。 |
| version    | 否    | String  | **参数解释：** 数据库版本号。查询指定版本支持的规格。例如1.4。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值**： 不涉及。                                                                                                                                                                                                                                                                                                                                                                        |
| spec_code  | 否    | String  | **参数解释：** 规格编码，查询指定规格编码的具体规格信息。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值**： 不涉及。                                                                                                                                                                                                                                                                                                                                                                                   |
| ha_mode    | 否    | String  | **参数解释：** 实例类型，查询指定实例类型支持的规格。 **约束限制：** 不涉及。 **取值范围：** - 集中式：centralization_standard  - 分布式（独立部署）：enterprise   **默认取值**： 不涉及。                                                                                                                                   |
| limit      | 否    | Integer | **参数解释：** 查询记录数。例如该参数设定为10，则查询结果最多只显示10条记录。 **约束限制：** 不涉及。 **取值范围：** \[1, 100\] **默认取值**： 默认为100。                                                                                                                                                                                                                                                                                                                                                                |
| offset     | 否    | Integer | **参数解释：** 索引位置，偏移量。从第一条数据偏移offset条数据后开始查询。例如：该参数指定为1，limit指定为10，则只展示第2\~11条数据。 **约束限制：** 不涉及。 **取值范围：** \[0, 2\^31-1\] **默认取值**： 默认为0（偏移0条数据，表示从第一条数据开始查询）。                                                                                                                                                                                                                                                                                                      |
   
#### 请求参数
无。
#### 响应参数
表2要素说明 
| 名称      | 参数类型             | 说明                                                                                                                                                                                             |
|:---|:---|:---|
| flavors | Array of objects | **参数解释：** 规格详情。 详情请参见[表3]。                      |
| total   | Integer          | **参数解释：** 总记录数。 **取值范围：** \[0, 2\^31-1\]，实际取决于查询。 |
   
 表3flavors说明 
| 名称                | 参数类型                 | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
|:---|:---|:---|
| vcpus             | String               | **参数解释：** CPU个数。 **取值范围：** 不涉及。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| ram               | String               | **参数解释：** 内存大小，单位为GB。 **取值范围：** 不涉及。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| spec_code         | String               | **参数解释：** 资源规格编码。参考[数据库实例规格](https://support.huaweicloud.com/api-gaussdb/gaussdb_api_199.html)。 **取值范围：** 不涉及。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| availability_zone | Array of strings     | **参数解释：** 支持该规格的AZ。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| az_status         | Map\<String,String\> | **参数解释：** 其中key是可用区编号，value是规格所在AZ的状态。 **取值范围：** - normal：可用。  - unsupported：不支持该规格。  - sellout：售罄。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| version           | String               | **参数解释：** 该规格支持的数据库版本号。 **取值范围：** 不涉及。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| name              | String               | **参数解释：** 数据库引擎名称。 **取值范围：** 不涉及。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| group_type        | String               | **参数解释：** 性能规格。 **取值范围：** - normal：独享型（1:8）。  - normal2：独享型（1:4）。  - armFlavors：鲲鹏独享型（1:8）。  - exclusive：独享型（1:4）。仅基础版集中式实例支持。  - armExclusive：鲲鹏独享型（1:4）。仅基础版集中式实例支持。  - economical：惠选型（1:4）。  - economical2：惠选型（1:8）。  - armFlavors2：鲲鹏独享型（1:4）。  - general：通用型（1:4）。   |
   
#### 请求示例
- 查询集中式版数据库规格
  ```
  GET https://gaussdb-opengauss.cn-north-1.myhuaweicloud.com/v3.1/0483b6b16e954cb88930a360d2c4e663/flavors?offset=0&limit=10&ha_mode=centralization_standard&version=3.208&spec_code=gaussdb.opengauss.ee.km1.2xlarge.arm8.ha
  ```
  

- 查询分布式数据库规格
  ```
  GET https://gaussdb-opengauss.cn-north-1.myhuaweicloud.com/v3.1/0483b6b16e954cb88930a360d2c4e663/flavors?offset=0&limit=10&ha_mode=enterprise&version=3.208&spec_code=gaussdb.opengauss.ee.dn.m6.2xlarge.8.in
  ```
  
 
#### 响应示例
查询数据库规格成功。
```
{
  "flavors": [
    {
      "vcpus": "2",
      "ram": "16",
      "availability_zone": [
        "az2xahz",
        "az1xahz",
        "az3xahz"
      ],
      "version": "1.4",
      "name": "GaussDB",
      "spec_code": "gaussdb.opengauss.ee.dn.m6.large.8.in",
      "az_status": {
        "az2xahz": "normal",
        "az1xahz": "normal",
        "az3xahz": "normal"
      },
      "group_type": "normal2"
    }
  ],
  "total": 1
}
```
#### 状态码
- 正常 200
  
- 异常 请参见[状态码](https://support.huaweicloud.com/api-gaussdb/gaussdb_api_194.html)。
  
 
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-gaussdb/gaussdb_api_195.html)。