文档首页/ 云数据库 GaussDB/ API参考/ 历史API/ 引擎版本和规格/ 查询数据库规格（v3.1）
更新时间：2024-12-24 GMT+08:00
查看PDF
分享

查询数据库规格（v3.1）

功能介绍

查询数据库的规格信息。

调试

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

URI

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

名称

是否必选

参数类型

说明

project_id

是

String

参数解释：

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

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

约束限制：

不涉及。

取值范围：

只能由英文字母、数字组成，且长度为32个字符。

默认取值：

不涉及。

version

否

String

参数解释：

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

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

spec_code

否

String

参数解释：

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

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

ha_mode

否

String

参数解释：

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

约束限制：

不涉及。

取值范围：

  • 集中式：centralization_standard
  • 分布式（独立部署）：enterprise

默认取值：

不涉及。

limit

否

Integer

参数解释：

查询记录数。例如该参数设定为10，则查询结果最多只显示10条记录。

约束限制：

不涉及。

取值范围：

[1, 100]

默认取值：

默认为100。

offset

否

Integer

参数解释：

索引位置，偏移量。从第一条数据偏移offset条数据后开始查询。例如：该参数指定为1，limit指定为10，则只展示第2~11条数据。

约束限制：

不涉及。

取值范围：

[0, 2^31-1]

默认取值：

默认为0（偏移0条数据，表示从第一条数据开始查询）。

请求参数

无。

响应参数

表2 要素说明

名称

参数类型

说明

flavors

Array of objects

参数解释：

规格详情。

详情请参见表3。

total

Integer

参数解释：

总记录数。

取值范围：

[0, 2^31-1]，实际取决于查询。
表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）。
  • exclusive：独享型（1:4）。仅基础版主备版实例支持。
  • armExclusive：鲲鹏独享型（1:4）。仅基础版主备版实例支持。
  • economical：惠选型（1:4）。
  • economical2：惠选型（1:8）。
  • armFlavors2：鲲鹏独享型（1:4）。
  • general：通用型（1:4）。

请求示例

  • 查询主备版数据库规格 
    GET https://gaussdb-opengauss.cn-north-1.myhuaweicloud.com/v3.1/0483b6b16e954cb88930a360d2c4e663/flavors?offset=0&limit=10&ha_mode=centralization_standard&version=3.208&spec_code=gaussdb.opengauss.ee.km1.2xlarge.arm8.ha
  • 查询分布式数据库规格 
    GET https://gaussdb-opengauss.cn-north-1.myhuaweicloud.com/v3.1/0483b6b16e954cb88930a360d2c4e663/flavors?offset=0&limit=10&ha_mode=enterprise&version=3.208&spec_code=gaussdb.opengauss.ee.dn.m6.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
}

状态码

错误码

请参见错误码。

父主题： 引擎版本和规格

相关文档