更新时间:2024-08-20 GMT+08:00
分享

查询数据库规格

功能介绍

查询数据库的规格信息。

调试

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

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

约束限制:

不涉及。

取值范围:

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

默认取值

不涉及。

version

String

参数解释:

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

约束限制:

不涉及。

取值范围:

不涉及。

默认取值

不涉及。

spec_code

String

参数解释:

规格编码,查询指定规格编码的具体规格信息。例如:3.208。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值

不涉及。

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)。
  • general:通用型(1:4)。
  • armFlavors2:鲲鹏独享型(1:4)。
  • exclusive:独享型(1:4)。仅基础版主备版实例支持。
  • armExclusive:鲲鹏独享型(1:4)。仅基础版主备版实例支持。
  • economical:惠选型(1:4)。
  • economical2:惠选型(1:8)。

请求示例

查询数据库规格。

https://gaussdb-opengauss.cn-north-1.myhuaweicloud.com/v3/0483b6b16e954cb88930a360d2c4e663/flavors?offset=0&limit=10&ha_mode=centralization_standard&version=3.100&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
}

状态码

错误码

请参见错误码

相关文档