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

查询实例可变更规格

功能介绍

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

调试

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

状态码

错误码

请参见错误码

相关文档