文档首页/ 云数据库 GaussDB/ API参考/ API（推荐）/ 引擎版本和规格/ 查询实例可变更规格
更新时间：2024-08-20 GMT+08:00
查看PDF
分享

查询实例可变更规格

功能介绍

查询实例可变更规格列表。

调试

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

URI

GET https://{Endpoint}/v3/{project_id}/instances/{instance_id}/available-flavors
表1 参数说明

名称

是否必选

参数类型

说明

project_id

是

String

参数解释：

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

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

约束限制：

不涉及。

取值范围：

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

默认取值：

不涉及。

instance_id

是

String

实例ID。

limit

否

Integer

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

offset

否

Integer

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

请求参数

无。

响应参数

表2 要素说明

名称

参数类型

说明

flavors

Array of objects

规格详情。

详情请参见表3。

total_count

integer

总记录数。
表3 flavors说明

名称

参数类型

说明

vcpus

string

CPU个数。

ram

string

内存大小，单位为GB。

spec_code

string

资源规格编码。例如：gaussdb.opengauss.ee.dn.m6.4xlarge.8.in。

az_status

Map<String,String>

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

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

请求示例

查询实例可变更规格，查询记录数为10，偏移量为0。 
GET https://gaussdb-opengauss.cn-north-4.myhuaweicloud.com/v3/054b61972980d4552f0bc00ac8d3f5cd/instances/dsfae23fsfdsae3435in14/available-flavors

响应示例

查询实例可变规格成功。 
{
  "flavors" : [ { 
     "spec_code" : "gaussdb.opengauss.ee.m6.2xlarge.x868.ha", 
     "vcpus" : "8", 
     "ram" : "64", 
     "az_status" : [ { 
       "az2xahz" : "normal" 
      } ] 
    } ], 
   "total_count" : 1
}

状态码

错误码

请参见错误码。

父主题： 引擎版本和规格

相关文档