查询数据库规格
URI
- URI格式
GET /v3/{project_id}/flavors/{database_name}?version_name={version_name}&spec_code={spec_code}&is_serverless={is_serverless}
- 参数说明
表1 参数说明 名称
是否必选
说明
project_id
是
参数解释:
租户在某一Region下的项目ID。
获取方法请参见获取项目ID。
约束限制:
不涉及。
取值范围:
不涉及。
默认取值:
不涉及。
database_name
是
参数解释:
数据库引擎名。
约束限制:
不涉及。
取值范围:
- MySQL
- PostgreSQL
- SQLServer
默认取值:
不涉及。
version_name
否
参数解释:
数据库版本号,获取方法请参见查询数据库引擎的版本。(可输入小版本号)
约束限制:
不涉及。
取值范围:
不涉及。
默认取值:
不涉及。
is_serverless
否
参数解释:
是否查询Serverless规格。
约束限制:
不涉及。
取值范围:
- true:查询Serverless规格。
- false:查询非Serverless规格。默认值 false。
默认取值:
不涉及。
spec_code
否
参数解释:
规格编码。
约束限制:
不涉及。
取值范围:
不涉及。
默认取值:
不涉及。
请求消息
响应消息
- 正常响应要素说明
表2 要素说明 名称
参数类型
说明
flavors
Array of objects
参数解释:
实例规格信息列表。
详情请参见表3。
表3 flavors字段数据结构说明 名称
参数类型
说明
vcpus
String
参数解释:
CPU大小。例如:1表示1U。
取值范围:
不涉及。
ram
Integer
参数解释:
内存大小,单位为GB。
取值范围:
不涉及。
id
String
参数解释:
规格ID,该字段唯一。
取值范围:
不涉及。
spec_code
String
参数解释:
资源规格编码。例如:rds.mysql.m1.xlarge.rr。
更多规格说明请参考数据库实例规格。
- “rds”代表RDS产品。
- “mysql”代表数据库引擎。
- “m1.xlarge”代表性能规格,为高内存类型。
- “rr”表示只读实例(“.ha”表示主备实例)。
- “rha.rr”表示高可用只读实例,规格编码示例:rds.mysql.n1.large.4.rha.rr。
- 具有公测权限的用户才可选择高可用,您可联系华为云客服人员申请。
- 高可用只读功能介绍请参见高可用只读简介。
取值范围:
不涉及。
version_name
Array
参数解释:
数据库版本号。
针对MySQL引擎,例如:["5.6","5.7","8.0"]
instance_mode
String
参数解释:
实例模型。
取值范围:
- ha:主备实例。
- replica:只读实例。
- single:单实例。
az_status
Map<String, String>
参数解释:
规格所在az的状态。
取值范围:
- normal:在售。
- unsupported:暂不支持该规格。
- sellout:售罄。
az_desc
Map<String, String>
参数解释:
规格所在az的描述。
取值范围:
不涉及。
group_type
String
参数解释:
性能规格。
取值范围:
- normal:通用增强型。
- normal2:通用增强Ⅱ型。
- armFlavors:鲲鹏通用增强型。
- dedicicateNormal(dedicatedNormalLocalssd):x86独享型。
- armLocalssd:鲲鹏通用型。
- normalLocalssd:x86通用型。
- general:通用型。
- dedicated
- 对于MySQL引擎:独享型。
- 对于PostgreSQL和SQL Server引擎:独享型,仅云盘SSD支持。
- rapid
- 对于MySQL引擎:独享型(已下线)。
- 对于PostgreSQL和SQL Server引擎:独享型,仅极速型SSD支持。
- bigmem:超大内存型。
- highPerformancePrivilegeEdition:超高IO 尊享版
- 正常响应样例
{ "flavors": [{ "vcpus": "1", "ram": 2, "id":"2988b9cc-2aac-3a94-898c-14666702f129", "spec_code": "rds.mysql.c2.medium.rr", "version_name": ["5.6","5.7","8.0"], "instance_mode": "ha", "az_status": { "az1": "normal", "az2": "normal" }, "az_desc": { "az1": "az1", "az2": "az2" }, "group_type": "normal" }, { "vcpus": "1", "ram": 2, "id":"2988b9cc-2aac-3a94-898c-14666702f130", "spec_code": "rds.mysql.c2.medium.rr", "version_name": ["5.6","5.7","8.0"], "instance_mode": "replica", "az_status": { "az1": "normal", "az2": "normal" }, "az_desc": { "az1": "az1", "az2": "az2" }, "group_type": "normal" } ] }
- 异常响应
请参见异常请求结果。
状态码
- 正常
- 异常
请参见状态码。
错误码
请参见错误码。