查询数据库规格-九游平台

功能介绍

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

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	参数解释： 规格所在az的状态。 取值范围： normal：在售。 unsupported：暂不支持该规格。 sellout：售罄。
  az_desc	map	参数解释： 规格所在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"
  		}
  	]
  }

状态码

• 正常

  200

• 异常

  请参见状态码。