文档首页/ 云数据库 TaurusDB/ API参考/ 历史API/ 查询数据库规格/ 查询数据库规格
更新时间：2025-07-31 GMT+08:00
查看PDF
分享

查询数据库规格

功能介绍

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

当前页面API为历史版本API，未来可能停止维护。建议及时切换到新接口查询数据库规格。

调试

您可以在API Explorer中调试该接口。

URI

GET /mysql/v3/{project_id}/flavors/{database_name}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

租户在某一Region下的project ID。

获取方法请参见获取项目ID。

database_name

是

String

数据库引擎名称。
表2 Query参数

参数

是否必选

参数类型

描述

version_name

否

String

数据库版本号，目前仅支持兼容MySQL 8.0。

availability_zone_mode

是

String

规格的可用区模式，现在仅支持"single"、"multi"，不区分大小写。

spec_code

否

String

规格编码。

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户Token。

通过调用IAM服务获取用户Token接口获取。

请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。

X-Language

否

String

请求语言类型。默认en-us。 取值范围：

  • en-us
  • zh-cn

响应参数

状态码： 200

表4 响应Body参数

参数

参数类型

描述

flavors

Array of MysqlFlavorsInfo objects

实例规格信息列表
表5 MysqlFlavorsInfo

参数

参数类型

描述

vcpus

String

CPU大小。例如：1表示1U。

ram

String

内存大小，单位为GB。

type

String

规格类型，取值为arm和x86。

id

String

规格ID，该字段唯一

spec_code

String

资源规格编码，同创建指定的flavor_ref。例如：gaussdb.mysql.xlarge.x86.4。

version_name

String

数据库版本号。

instance_mode

String

实例类型。目前仅支持Cluster。

az_status

Map<String,String>

规格所在az的状态，包含以下状态：

  • normal，在售
  • unsupported，暂不支持该规格
  • sellout，售罄。

状态码： 400

表6 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误消息。

状态码： 500

表7 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误消息。

请求示例

GET https://{endpoint}/mysql/v3/0483b6b16e954cb88930a360d2c4e663/flavors/gaussdb-mysql?version_name=8.0&spec_code=gaussdb.mysql.xlarge.x86.4&availability_zone_mode=single

响应示例

状态码： 200

Success.

{
  "flavors" : [ {
    "type" : "x86",
    "vcpus" : "1",
    "ram" : "4",
    "id" : "3169caaf-6c2f-41d5-aadd-c8fc3d83597e",
    "spec_code" : "gaussdb.mysql.xlarge.x86.4",
    "instance_mode" : "Cluster",
    "version_name" : "8.0",
    "az_status" : {
      "cn-north-4a" : "normal",
      "cn-north-4b" : "normal"
    }
  } ]
}

状态码

状态码

描述

200

Success.

400

Client error.

500

Server error.

错误码

请参见错误码。

父主题： 查询数据库规格

相关文档