功能介绍

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

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

调试

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

URI

URI格式

GET https://{Endpoint}/v3/{project_id}/instances/{instance_id}/available-flavors

URI样例

https://gaussdb-opengauss.cn-north-4.myhuaweicloud.com/v3/054b61972980d4552f0bc00ac8d3f5cd/instances/dsfae23fsfdsae3435in14/available-flavors

参数说明

表1 参数说明

名称	是否必选	参数类型	说明
project_id	是	String	租户在某一region下的project ID。 获取方法请参见获取项目ID/名称。
instance_id	是	String	实例ID。
limit	否	Integer	查询记录数。默认为100，不能为负数，最小值为1，最大值为100。例如该参数设定为10，则查询结果最多只显示10条记录。
offset	否	Integer	索引位置，偏移量。从第一条数据偏移offset条数据后开始查询，默认为0（偏移0条数据，表示从第一条数据开始查询），必须为数字，不能为负数。例如：该参数指定为1，limit指定为10，则只展示第2-11条数据。

请求消息

查询实例可变更规格，查询记录数为10，偏移量为0。

{
	"GET https://gaussdb-opengauss.cn-north-1.myhuaweicloud.com/v3/0611f1bd8b00d5d32f17c017f15b599f/instances/dsfae23fsfdsae3435in14/available-flavors?limit=10&offset=0
}

响应消息

正常响应要素说明

表2 要素说明

名称	参数类型	说明
flavors	Array of objects	规格详情。 详情请参见表3。
total_count	integer	总记录数。

表3 flavors说明

名称	参数类型	说明
vcpus	string	CPU个数。
ram	string	内存大小，单位为GB。
spec_cpde	string	资源规格编码。例如：gaussdb.opengauss.ee.dn.m6.4xlarge.8.in。
az_status	Map	其中key是可用区编号，value是规格所在az的状态,包含以下状态： normal：可用。 unsupported：不支持该规格。 sellout：售罄。

正常响应样例

{
  "flavors" : [ { 
     "spec_cpde" : "gaussdb.opengauss.ee.m6.2xlarge.x868.ha", 
     "vcpus" : "8", 
     "ram" : "64", 
     "az_status" : [ { 
       "az2xahz" : "normal" 
      } ] 
    } ], 
   "total_count" : 1
}

异常响应

请参见异常请求结果。

状态码

正常

200

异常

请参见状态码。

错误码

请参见错误码。

父主题： 引擎版本和规格

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

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