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

功能介绍

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

• 调用接口前，您需要了解api 。

调试

您可以在中调试该接口。

uri

• uri格式

  get /v3/{project_id}/flavors/{database_name}?version_name={version_name}&spec_code={spec_code}&is_serverless={is_serverless}

• 参数说明

  表1 参数说明

  名称	是否必选	说明
  project_id	是	参数解释： 租户在某一region下的项目id。 获取方法请参见。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。
  database_name	是	参数解释： 数据库引擎名。 约束限制： 不涉及。 取值范围： mysql postgresql sqlserver 默认取值： 不涉及。
  version_name	否	参数解释： 数据库版本号，获取方法请参见。（可输入小版本号） 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。
  is_serverless	否	参数解释： 是否查询serverless规格。 约束限制： 不涉及。 取值范围： true：查询serverless规格。 false：查询非serverless规格。默认值 false。 默认取值： 不涉及。
  spec_code	否	参数解释： 规格编码。 说明： rds for mysql规格码请参见。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。

请求消息

• 请求参数

  无。

• uri样例

  get https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/flavors/mysql?version_name=5.7&spec_code=rds.mysql.m1.xlarge.rr

响应消息

• 正常响应要素说明

  表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”表示主备实例）。 “rha.rr”表示高可用只读实例，规格编码示例：rds.mysql.n1.large.4.rha.rr。 具有公测权限的用户才可选择高可用，您可联系华为云客服人员申请。 高可用只读功能介绍请参见。 取值范围： 不涉及。
  version_name	array	参数解释： 数据库版本号。 针对mysql引擎，例如：["5.6","5.7","8.0"]
  instance_mode	string	参数解释： 实例模型。 取值范围： ha：主备实例。 replica：只读实例。 single：单实例。
  az_status	map	参数解释： 规格所在az的状态。 取值范围： normal：在售。 unsupported：暂不支持该规格。 sellout：售罄。
  az_desc	map	参数解释： 规格所在az的描述。 取值范围： 不涉及。
  group_type	string	参数解释： 性能规格。 取值范围： normal：通用增强型。 normal2：通用增强ⅱ型。 armflavors：鲲鹏通用增强型。 dedicicatenormal（dedicatednormallocalssd）：x86独享型。 armlocalssd：鲲鹏通用型。 normallocalssd：x86通用型。 general：通用型。 dedicated 对于mysql引擎：独享型。 对于postgresql和sql server引擎：独享型，仅云盘ssd支持。 rapid 对于mysql引擎：独享型（已下线）。 对于postgresql和sql server引擎：独享型，仅极速型ssd支持。 bigmem：超大内存型。 highperformanceprivilegeedition：超高io 尊享版

• 正常响应样例

  {
  	"flavors": [{
  			"vcpus": "1",
  			"ram": 2,
                          "id":"2988b9cc-2aac-3a94-898c-14666702f129",
  			"spec_code": "rds.mysql.c2.medium.rr",
                          "version_name": ["5.6","5.7","8.0"],
  			"instance_mode": "ha",
  			"az_status": {
  				"az1": "normal",
  				"az2": "normal"
  			},
  			"az_desc": {
  				"az1": "az1",
  				"az2": "az2"
  			},
                          "group_type": "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"
  			},
  			"az_desc": {
  				"az1": "az1",
  				"az2": "az2"
  			},
                          "group_type": "normal"
  		}
  	]
  }

• 异常响应

  请参见。

状态码

• 正常

  200

• 异常

  请参见。

错误码

请参见。