# 查询数据库规格 - ListFlavors #### 功能介绍 获取指定数据库引擎版本对应的规格信息。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-rds/rds_10_0005.html)。 - 如果使用身份策略授权，需具备如下身份策略权限。 | 授权项 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 | |:---|:---|:---|:---|:---|:---| | rds:instance:listFlavors | read | - | - | - | - | #### URI - URI格式 GET /v3/{project_id}/flavors/{database_name}?version_name={version_name}\&spec_code={spec_code}\&is_flexus={is_flexus} - 参数说明 表1参数说明 | 名称 | 是否必选 | 说明 | |:---|:---|:---| | project_id | 是 | **参数解释**： 租户在某一Region下的项目ID。 获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-flexusrds/rds_03_0002.html)。 **约束限制**： 不涉及。 **取值范围**： 不涉及。 **默认取值**： 不涉及。 | | database_name | 是 | **参数解释：** 数据库引擎。 **约束限制：** 不涉及。 **取值范围：** MySQL，不区分大小写。 **默认取值：** 不涉及。 | | version_name | 否 | **参数解释**： 数据库版本号，可输入小版本号。 **约束限制**： 不涉及。 **取值范围**： 不涉及。 **默认取值**： 不涉及。 | | is_flexus | 是 | **参数解释**： 是否查询FlexusRDS实例规格。 **约束限制**： 不涉及。 **取值范围**： - true：查询FlexusRDS规格。 - false：查询非FlexusRDS规格。默认值false。 **默认取值**： false | | spec_code | 否 | **参数解释**： 规格编码。 **约束限制**： 不涉及。 **取值范围**： - 单机实例： rds.mysql.y1.medium.2 rds.mysql.y1.large.2 rds.mysql.y1.large.4 rds.mysql.y1.xlarge.2 rds.mysql.y1.xlarge.4 - 主备实例： rds.mysql.y1.large.2.ha rds.mysql.y1.large.4.ha rds.mysql.y1.xlarge.2.ha rds.mysql.y1.xlarge.4.ha **默认取值**： 不涉及。 | #### 请求参数 无。 #### 请求示例 ``` GET https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/flavors/mysql?version_name=5.7&spec_code=rds.mysql.y1.xlarge.2 ``` #### 响应消息 - 正常响应要素说明 表2要素说明 | 名称 | 参数类型 | 说明 | |:---|:---|:---| | flavors | Array of objects | **参数解释：** 实例规格信息列表。详情请参见[表3]。 | 表3flavors字段数据结构说明 | 名称 | 参数类型 | 说明 | |:---|:---|:---| | vcpus | String | **参数解释：** CPU大小。例如：1表示1U。 **取值范围：** 不涉及。 | | ram | Integer | **参数解释：** 内存大小，单位为GB。 **取值范围：** 不涉及。 | | id | String | **参数解释：** 规格ID，该字段唯一。 **取值范围：** 不涉及。 | | spec_code | String | **参数解释：** 资源规格编码。例如：rds.mysql.y1.xlarge.2.ha。 **取值范围：** - "rds"代表RDS产品。 - "mysql"代表数据库引擎。 - "y1.xlarge"代表性能规格，为轻量型规格。 - "ha"表示主备实例。 | | version_name | Array | **参数解释：** 数据库版本号。 | | instance_mode | String | **参数解释：** 实例模型。 **取值范围：** - ha：主备实例。 - single：单实例。 | | az_status | Map\ | **参数解释：** 规格所在az的状态。 **取值范围：** - normal：在售。 - unsupported：暂不支持该规格。 - sellout：售罄。 | | az_desc | Map\ | **参数解释：** 规格所在az的描述。 **取值范围：** 不涉及。 | | group_type | String | **参数解释：** FlexusRDS的性能规格。 **取值范围：** yunyao：Flexus轻量型。 | - 正常响应样例 ``` { "flavors": [{ "vcpus": "1", "ram": 2, "id":"2988b9cc-2aac-3a94-898c-14666702f129", "spec_code": "rds.mysql.y1.xlarge.2.ha", "version_name": ["5.7","8.0"], "instance_mode": "ha", "az_status": { "az1": "normal", "az2": "normal" }, "az_desc": { "az1": "az1", "az2": "az2" }, "group_type": "yunyao" } ] } ``` #### 状态码 - 正常 200 - 异常 请参见[状态码](https://support.huaweicloud.com/api-flexusrds/rds_10_0200.html)。