功能介绍

查询数据库的规格信息。

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

调试

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

URI

URI格式

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

URI样例

查询集中式数据库规格

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

查询分布式数据库规格

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

参数说明

表1 参数说明

名称	是否必选	参数类型	说明
project_id	是	String	租户在某一region下的project 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	其中key是可用区编号，value是规格所在az的状态,包含以下状态： normal：可用。 unsupported：不支持该规格。 sellout：售罄。
version	string	该规格支持的数据库版本号。
name	string	数据库引擎名称。
group_type	string	性能规格，包含以下状态： normal：通用增强型。 normal2:通用增强II型。 armFlavors：鲲鹏通用增强型。 dedicicatenormal ：x86独享型。 armlocalssd：鲲鹏通用型。 normallocalssd：x86通用型。 general：通用型。 dedicated：独享型,仅云盘SSD支持。 rapid：独享型，仅极速型SSD支持。

正常响应样例

{
  "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
}

异常响应

请参见异常请求结果。

状态码

正常

200

异常

请参见状态码。

错误码

请参见错误码。

父主题： 引擎版本和规格

同意关联代理商云淘科技，购买华为云产品更优惠（QQ 78315851）

内容没看懂？ 不太想学习？想快速解决？ 有偿解决： 联系专家