更新时间:2024-02-27 GMT+08:00

查询数据库规格

功能介绍

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

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

租户在某一Region下的project ID。

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

database_name

String

数据库引擎名称。

表2 Query参数

参数

是否必选

参数类型

描述

availability_zone_mode

String

规格的可用区模式。

取值范围:

  • single:单可用区。
  • multi:多可用区。

version_name

String

数据库版本号,获取方法请参见查询数据库引擎的版本

目前仅支持兼容MySQL 8.0。

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

响应参数

状态码: 202

表4 响应Body参数

参数

参数类型

描述

flavors

Array of MysqlFlavorsInfo objects

实例规格信息列表。

表5 MysqlFlavorsInfo

参数

参数类型

描述

vcpus

String

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

ram

String

内存大小,单位为GB。

type

String

规格类型。

取值范围:

  • arm:独享型arm规格。
  • x86:独享型x86规格。
  • generalX86:通用型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

错误消息。

请求示例

查询GaussDB(for MySQL)数据库实例指定规格的详细信息。

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

响应示例

状态码: 202

Success.

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

状态码

请参见状态码

错误码

请参见错误码