GaussDB查询数据库规格

最新推荐文章于 2025-02-26 15:42:33 发布

wangpei0303

最新推荐文章于 2025-02-26 15:42:33 发布

阅读量501

点赞数 3

文章标签：数据库 gaussdb

本文链接：https://blog.youkuaiyun.com/m0_60569209/article/details/143933254

版权

查询数据库规格

功能介绍

查询数据库的规格信息。

调用接口前，您需要了解API 认证鉴权。
调用接口前，您需要提前获取到地区和终端节点，即下文中的Endpoint值。

调试

您可以在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
}