更新时间:2024-08-09 GMT+08:00
分享

查询数据库规格

功能介绍

获取指定数据库引擎版本对应的规格信息。

调试

您可以在API Explorer中调试该接口。

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

    参数解释

    规格编码。

    说明:

    RDS for MySQL规格码请参见云数据库 RDS for MySQL实例类型

    约束限制

    不涉及。

    取值范围

    不涉及。

    默认取值

    不涉及。

请求消息

  • 请求参数

    无。

  • URI样例

    GET https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/flavors/mysql?version_name=5.7&spec_code=rds.mysql.m1.xlarge.rr

响应消息

  • 正常响应要素说明
    表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"
    		}
    	]
    }
  • 异常响应

    请参见异常请求结果

状态码

错误码

请参见错误码

相关文档