查询实例可变更规格
功能介绍
查询实例可变更规格。
接口约束
该接口支持如下数据库实例:
- 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 } }
状态码
请参见状态码。
错误码
请参见错误码。