查询数据库规格

功能介绍

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

• 调用接口前，您需要了解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。 获取方法请参见获取项目ID。
  database_name	是	数据库引擎名。支持如下数据库引擎，不区分大小写： MySQL PostgreSQL SQLServer
  version_name	否	数据库版本号，获取方法请参见查询数据库引擎的版本。（可输入小版本号）
  is_serverless	否	是否查询Serverless规格。取值范围如下，区分大小写： true：查询Serverless规格。 false：查询非Serverless规格。默认值 false。
  spec_code	否	规格编码。

请求消息

• 请求参数

  无。

• 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<String, String>	规格所在az的状态，包含以下状态： normal：在售。 unsupported：暂不支持该规格。 sellout：售罄。
  az_desc	Map<String, String>	规格所在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.rrrds.pg.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.rrrds.pg.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

• 异常

  请参见状态码。

错误码

请参见错误码。