查询数据库规格

功能介绍

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

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

URI

• URI格式

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

• URI样例

  https://{Endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/flavors/mysql?version_name=5.7

• 参数说明

  表1 参数说明

  名称	是否必选	说明
  project_id	是	租户在某一region下的project ID。 获取方法请参见获取项目ID。
  database_name	是	数据库引擎名。支持如下数据库引擎，不区分大小写： MySQL PostgreSQL
  version_name	否	数据库版本号，获取方法请参见查询数据库引擎的版本。
  spec_code	否	规格编码。

请求消息

无。

响应消息

• 正常响应要素说明

  表2 要素说明

  名称	参数类型	说明
  flavors	Array of objects	实例规格信息列表。 详情请参见表3。

  表3 flavors字段数据结构说明

  名称	参数类型	说明
  vcpus	String	CPU大小。例如：1表示1U。
  ram	Integer	内存大小，单位为GB。
  spec_code	String	资源规格编码。例如：rds.mysql.m1.xlarge.rr。 “rds”代表RDS产品。 “mysql”代表数据库引擎。 “m1.xlarge”代表性能规格，为高内存类型。 “rr”表示只读实例（“.ha”表示主备实例）。
  instance_mode	String	实例模型，包括如下类型： ha，主备实例。 replica，只读实例。 single，单实例。
  az_status	Map<String, String>	规格所在az的状态，包含以下状态： normal，在售。 unsupported，暂不支持该规格。 sellout，售罄。

• 正常响应样例

  {
  	"flavors": [{
  		"vcpus": "1",
  		"ram": 2,
  		"spec_code": "rds.mysql.c2.medium.ha",
  		"instance_mode": "ha",
  		"az_status": {
  			"az1": "normal",
  			"az2": "normal"
  		}
  	}, {
  		"vcpus": "1",
  		"ram": 2,
  		"spec_code": "rds.mysql.c2.medium.rr",
  		"instance_mode": "replica",
  		"az_status": {
  			"az1": "normal",
  			"az2": "normal"
  		}
  	}]
  }

• 异常响应

  请参见异常请求结果。

状态码

请参见状态码。

错误码

请参见错误码。