查询实例可变更规格 - QueryingSpecificationsthataDBInstanceCanBeChangedTo
调试
您可以在API Explorer中调试该接口。
URI
GET /v3/{project_id}/instances/{instance_id}/available-flavors
| 名称 | 是否必选 | 参数类型 | 说明 |
|---|---|---|---|
| project_id | 是 | String | 参数解释: 租户在某一Region下的项目ID。 获取方法请参见获取项目ID。 约束限制: 不涉及。 取值范围: 只能由英文字母、数字组成,且长度为32个字符。 默认取值: 不涉及。 |
| instance_id | 是 | String | 参数解释: 实例ID,此参数是用户创建实例的唯一标识。请参考查询数据库实例列表 - QueryingDBInstances接口获取实例ID。 约束限制: 不涉及。 取值范围: 只能由英文字母、数字组成,且长度为36个字符。 默认取值: 不涉及。 |
| limit | 否 | Integer | 参数解释: 查询记录数。例如该参数设定为10,则查询结果最多只显示10条记录。 约束限制: 不能为负数。 取值范围: [1, 100] 默认取值: 100 |
| offset | 否 | Integer | 参数解释: 索引位置,偏移量。例如:该参数指定为1,limit指定为10,则只展示第2-11条数据。 约束限制: 不能为负数。 取值范围: 不涉及。 默认取值: 默认为0(偏移0条数据,表示从第一条数据开始查询)。 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| X-Auth-Token | 是 | String | 参数解释: 用户Token。 通过调用IAM服务获取用户Token接口获取。 请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| X-Language | 否 | String | 参数解释: 指定接口返回信息的语言类型。 约束限制: 不涉及。 取值范围:
默认取值: en-us |
响应参数
| 名称 | 参数类型 | 说明 |
|---|---|---|
| flavors | Array of objects | 参数解释: 规格详情。 详情请参见表4。 |
| total_count | integer | 参数解释: 实例可变更规格的总记录数。 取值范围: 不涉及。 |
| 名称 | 参数类型 | 说明 |
|---|---|---|
| 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的状态,包含以下状态:
|
请求示例
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
} 状态码
- 正常
- 异常
请参见状态码。
错误码
请参见错误码。