文档首页> 云数据库 GaussDB> API参考> 历史API> 引擎版本和规格> 查询数据库规格
更新时间：2024-07-12 GMT+08:00
查看PDF

查询数据库规格

功能介绍

查询数据库的规格信息。

URI

GET https://{Endpoint}/v3/{project_id}/flavors?limit={limit}&offset={offset}&ha_mode={ha_mode}&version={version}&spec_code={spec_code}
表1 参数说明

名称

是否必选

参数类型

说明

project_id

是

String

租户在某一Region下的项目ID。

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

version

否

String

数据库版本号。查询指定版本支持的规格。例如1.4

spec_code

否

String

规格编码，查询指定规格编码的具体规格信息。

ha_mode

否

String

实例类型，查询指定实例类型支持的规格。

集中式：centralization_standard

分布式：enterprise

limit

否

Integer

查询记录数。默认为100，不能为负数，最小值为1，最大值为100。例如该参数设定为10，则查询结果最多只显示10条记录。

offset

否

Integer

索引位置，偏移量。从第一条数据偏移offset条数据后开始查询，默认为0（偏移0条数据，表示从第一条数据开始查询），必须为数字，不能为负数。例如：该参数指定为1，limit指定为10，则只展示第2-11条数据。

请求参数

无。

响应参数

表2 响应参数

名称

参数类型

说明

flavors

Array of objects

规格详情。

详情请参见表3。

total

integer

总记录数。
表3 flavors说明

名称

参数类型

说明

vcpus

string

CPU个数。

ram

string

内存大小，单位为GB。

spec_code

string

资源规格编码。参考数据库实例规格

availability_zone

Array of strings

支持该规格的AZ。

az_status

Map<String,String>

其中key是可用区编号，value是规格所在az的状态,包含以下状态：

  • normal：可用。
  • unsupported：不支持该规格。
  • sellout：售罄。

version

string

该规格支持的数据库版本号。

name

string

数据库引擎名称。

group_type

string

性能规格，包含以下状态：

  • normal：独享型（1:8）。
  • normal2：独享型（1:4）。
  • armFlavors：鲲鹏独享型（1:8）。
  • general：通用型（1:4）。

请求示例

查询数据库规格。

https://gaussdb-opengauss.ap-southeast-1.myhuaweicloud.com/v3/0483b6b16e954cb88930a360d2c4e663/flavors?offset=0&limit=10&ha_mode=centralization_standard&version=3.100&spec_code=gaussdb.opengauss.ee.dn.m4.2xlarge.8.in

响应示例

{
  "flavors": [
    {
      "vcpus": "2",
      "ram": "16",
      "availability_zone": [
        "az2xahz",
        "az1xahz",
        "az3xahz"
      ],
      "version": "1.4",
      "name": "GaussDB",
      "spec_code": "gaussdb.opengauss.ee.dn.m6.large.8.in",
      "az_status": {
        "az2xahz": "normal",
        "az1xahz": "normal",
        "az3xahz": "normal"
      },
      "group_type": "normal2"
    }
  ],
  "total": 1
}

状态码

错误码

请参见错误码。

父主题： 引擎版本和规格