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

查询数据库规格

功能介绍

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

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

    约束限制

    不涉及。

    取值范围

    不涉及。

    默认取值

    不涉及。

    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

    表3 flavors字段数据结构说明

    名称

    参数类型

    说明

    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<String, String>

    参数解释:

    规格所在az的状态。

    取值范围:

    • normal:在售。
    • unsupported:暂不支持该规格。
    • sellout:售罄。

    az_desc

    Map<String, String>

    参数解释:

    规格所在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"
    		}
    	]
    }

状态码