查询数据库规格

功能介绍

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

• 调用接口前，您需要了解API 认证鉴权。
• 调用接口前，您需要提前获取到地区和终端节点，即下文中的Endpoint值。

URI

• URI格式

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

• URI样例

  https://rds.my-kualalumpur-1.alphaedge.tmone.com.my/v3/0483b6b16e954cb88930a360d2c4e663/flavors/mysql?version_name=5.7

• 参数说明

  表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。 “rds”代表RDS产品。 “mysql”代表数据库引擎。 “m1.xlarge”代表性能规格，为高内存类型。 “rr”表示只读实例（“.ha”表示主备实例）。
  version_name	Array	数据库版本号。
  instance_mode	String	实例模型，包括如下类型： ha，主备实例。 replica，只读实例。 single，单实例。
  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"
  			}
  		}
  	]
  }

• 异常响应

  请参见异常请求结果。

状态码

请参见状态码。

错误码

请参见错误码。