文档首页 > > API参考> API v3(推荐)> 查询数据库规格

查询数据库规格

分享
更新时间: 2020/06/29 GMT+08:00

功能介绍

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

URI

  • URI格式

    GET https://{Endpoint}/v3/{project_id}/flavors/{database_name}?version_name={version_name}&spec_code={spec_code}

  • URI样例

    https://rds.cn-north-1.myhuaweicloud.com/v3/0483b6b16e954cb88930a360d2c4e663/flavors/mysql?version_name=5.7&spec_code=rds.mysql.m1.xlarge.rr

  • 参数说明
    表1 参数说明

    名称

    是否必选

    说明

    project_id

    租户在某一region下的project ID。

    获取方法请参见获取项目ID

    database_name

    数据库引擎名。支持如下数据库引擎,不区分大小写:

    • MySQL
    • PostgreSQL
    • SQLServer

    version_name

    数据库版本号,获取方法请参见查询数据库引擎的版本。(可输入小版本号)

    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。

    其中形如“xxx.xxx.mcs.i3.xxx.xxx.xxx”是超高性能型(尊享版),需要申请一定权限才可使用,更多规格说明请参考数据库实例规格

    • “rds”代表RDS产品。
    • “mysql”代表数据库引擎。
    • “m1.xlarge”代表性能规格,为高内存类型。
    • “rr”表示只读实例(“.ha”表示主备实例,“gr”表示MySQL金融版)。

    version_name

    Array

    数据库版本号。

    针对MySQL引擎,例如:{5.6,5.7,8.0}

    instance_mode

    String

    实例模型,包括如下类型:

    • ha,主备实例。
    • replica,只读实例。
    • single,单实例。
    • gr,MySQL金融版。

    az_status

    Map<String, String>

    规格所在az的状态,包含以下状态:

    • normal,在售。
    • unsupported,暂不支持该规格。
    • sellout,售罄。
  • 正常响应样例
    {
    	"flavors": [{
    			"vcpus": "1",
    			"ram": 2,
                            "id":"2988b9cc-2aac-3a94-898c-14666702f129",
    			"spec_code": "rds.mysql.c2.medium.ha",
                            "version_name": "{5.6,5.7,8.0}",
    			"instance_mode": "ha",
    			"az_status": {
    				"az1": "normal",
    				"az2": "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"
    			}
    		}
    	]
    }
  • 异常响应

    请参见异常请求结果

状态码

请参见状态码

错误码

请参见错误码

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问