查询实例可变更规格
功能介绍
查询实例可变更规格。
接口约束
该接口支持如下数据库实例:
- GeminiDB Cassandra
- GeminiDB Mongo
- GeminiDB Influx
- GeminiDB Redis
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
GET /v3/{project_id}/instances/{instance_id}/available-flavors
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
参数解释: 租户在某一region下的project ID。获取方法请参见获取项目ID。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
|
instance_id |
是 |
String |
参数解释: 实例ID。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
offset |
否 |
Integer |
参数解释: 索引位置,偏移量,表示从第一条数据偏移offset条数据后开始查询。 约束限制: 不涉及 取值范围: 取值大于或等于0。 默认取值: 0 |
|
limit |
否 |
Integer |
参数解释: 查询个数上限值。 约束限制: 不涉及 取值范围:
默认取值: 100 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
参数解释: 用户Token。 通过调用IAM服务获取用户Token接口获取。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
响应参数
状态码: 200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
instance_id |
String |
参数解释: 实例id。 取值范围: 不涉及。 |
|
instance_name |
String |
参数解释: 实例名称。 取值范围: 不涉及。 |
|
current_flavor |
ComputeFlavor object |
参数解释: 实例当前规格信息。 |
|
optional_flavors |
OptionalFlavorsInfo object |
参数解释: 实例规格变更时可用的规格列表信息。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
vcpus |
String |
参数解释: cpu核数。 取值范围: 不涉及。 |
|
ram |
String |
参数解释: 内存大小,单位为GB。 取值范围: 不涉及。 |
|
spec_code |
String |
参数解释: 规格码。 取值范围: 不涉及。 |
|
az_status |
Map<String,String> |
参数解释: 可用区状态。 取值范围:
|
|
region_status |
String |
参数解释: Region状态。 取值范围
|
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
list |
Array of ComputeFlavor object |
参数解释: 实例规格变更时可用的规格列表。 |
|
total_count |
Integer |
参数解释: 总记录数。 取值范围: 不涉及。 |
请求示例
响应示例
状态码: 200
{
"instance_id" : "094424666ef04f79a2dfbe9f5b8b31a5in06",
"instance_name" : "geminidb_instance_noreuse_0_ZKv2FSkxgoc3F8bGzsaxNg",
"current_flavor" : {
"vcpus" : "4",
"ram" : "16",
"spec_code" : "geminidb.cassandra.xlarge.4",
"az_status" : {
"az2***" : "unknown",
"az1***" : "normal",
"az3***" : "unknown"
},
"region_status" : null
},
"optional_flavors" : {
"list" : [ {
"vcpus" : "2",
"ram" : "8",
"spec_code" : "geminidb.cassandra.large.4",
"az_status" : {
"az2***" : "unknown",
"az1***" : "normal",
"az4***" : "normal",
"az3***" : "unknown"
},
"region_status" : "normal"
}, {
"vcpus" : "8",
"ram" : "32",
"spec_code" : "geminidb.cassandra.2xlarge.4",
"az_status" : {
"az2***" : "unknown",
"az1***" : "normal",
"az3***" : "unknown"
},
"region_status" : "normal"
}, {
"vcpus" : "16",
"ram" : "64",
"spec_code" : "geminidb.cassandra.4xlarge.4",
"az_status" : {
"az2***" : "unknown",
"az1***" : "normal",
"az3***" : "unknown"
},
"region_status" : "normal"
}, {
"vcpus" : "32",
"ram" : "128",
"spec_code" : "geminidb.cassandra.8xlarge.4",
"az_status" : {
"az2***" : "unknown",
"az1***" : "normal",
"az3***" : "unknown"
},
"region_status" : "normal"
} ],
"total_count": 4
}
}
状态码
请参见状态码。
错误码
请参见错误码。