根据快照ID查询规格信息
功能介绍
根据快照ID查询规格信息。支持用来查询某个快照的规格信息,或者快照可恢复到的目标规格信息。
调用方法
请参见如何调用API。
URI
GET /v2/{project_id}/snapshots/{snapshot_id}/flavors
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
参数解释: 项目ID。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
|
snapshot_id |
是 |
String |
参数解释: 快照ID。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
type |
否 |
String |
参数解释: 过滤快照规格类型,用于区分仅查询快照原始规格,还是包含可恢复的规格。 约束限制: 不涉及。 取值范围: snapshot:仅查询快照的规格信息 restore:同时查询恢复快照可用的规格信息 默认取值: snapshot |
|
az_code |
否 |
String |
参数解释: 恢复时的目标可用区,用以过滤目标可用区下可恢复的规格。 恢复3az集群时需传递3个可用区编码,英文逗号分割(无空格)。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 快照原始集群所在可用区。 |
|
fine_grained_restore |
否 |
Boolean |
参数解释: 是否是细粒度备份恢复,用以过滤恢复时的可用规格。 约束限制: 不涉及。 取值范围: true|false 默认取值: false |
请求参数
无
响应参数
状态码:200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
flavors |
Array of ProductUnitResp objects |
参数解释: 快照规格信息响应。 取值范围: 不涉及。 |
|
count |
Integer |
参数解释: 快照规格信息总条数。 取值范围: 大于等于0的正整数。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
id |
String |
参数解释: 规格ID。 取值范围: 不涉及。 |
|
code |
String |
参数解释: 规格编码。 取值范围: 不涉及。 |
|
default_capacity |
String |
参数解释: 规格默认容量。 取值范围: 不涉及。 |
|
classify |
String |
参数解释: 规格类型。 取值范围: 不涉及。 |
|
scenario |
String |
参数解释: 规格适用场景。 取值范围: 不涉及。 |
|
version |
String |
参数解释: 规格版本信息。 取值范围: v1.0:一代规格。 v2.0:二代规格。 |
|
status |
String |
参数解释: 规格状态。 取值范围: 不涉及。 |
|
attribute |
Array of ProductExtendResp objects |
参数解释: 扩展信息。 取值范围: 不涉及。 |
|
duplicate |
Integer |
参数解释: 规格使用副本数量。 取值范围: 不涉及。 |
|
default_node |
Integer |
参数解释: 默认节点数量。 取值范围: 不涉及。 |
|
min_node |
Integer |
参数解释: 最小节点数。 取值范围: 不涉及。 |
|
max_node |
Integer |
参数解释: 最大节点数。 取值范围: 不涉及。 |
|
product_version_list |
Array of ProductVersionResp objects |
参数解释: 版本信息。 取值范围: 不涉及。 |
|
flavor_id |
String |
参数解释: 底层规格ID。有别于id字段,一般不会用到。 取值范围: 不涉及。 |
|
flavor_code |
String |
参数解释: 规格的底层规格编码。 取值范围: 不涉及。 |
|
volume_num |
Integer |
参数解释: 规格的磁盘数。 取值范围: 不涉及。 |
|
volume_used |
ProductVolumeUsedResp object |
参数解释: 创建快照时对应集群的磁盘使用信息。 取值范围: 不涉及。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
code |
String |
参数解释: 集群维度规格扩展信息编号。 取值范围: 不涉及。 |
|
value |
String |
参数解释: 集群维度规格扩展信息值。 取值范围: 不涉及。 |
请求示例
根据快照ID查询规格信息。
GET https://{Endpoint}/v2/05f2cff45100d5112f4bc00b794ea08e/snapshots/46921d1d-3d15-4a6f-8834-520c108c03da/flavors?type=snapshot
响应示例
状态码:200
查询成功。
{
"flavors" : [ {
"id" : "908c1620-4cd8-3803-9082-2b29fc966917",
"code" : "dws2.km1.xlarge",
"classify" : "dws",
"scenario" : "non-production",
"version" : "v1.0",
"status" : "enable",
"attribute" : [ {
"code" : "maxQueue",
"value" : ""
}, {
"code" : "cpuNum",
"value" : "4"
}, {
"code" : "memSize",
"value" : "32"
}, {
"code" : "ioGbSec",
"value" : ""
}, {
"code" : "diskType",
"value" : "SSD"
}, {
"code" : "localDisk",
"value" : "N"
} ],
"duplicate" : 2,
"default_node" : 3,
"min_node" : 3,
"max_node" : 32,
"default_capacity" : "200",
"product_version_list" : [ {
"min_cn" : 2,
"max_cn" : 20,
"version_type" : "1",
"datastore_version" : "9.1.0.215"
} ],
"flavor_id" : "e7fe0f10-5ec7-45f5-8558-c8b50ad88b34",
"flavor_code" : "rc6.xlarge.4",
"volume_num" : 2,
"volume_used" : {
"volume_type" : "SATA",
"volume_num" : 2,
"capacity" : 200,
"volume_size" : 200
}
} ],
"count" : 1
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
查询成功。 |
|
400 |
请求错误。 |
|
401 |
鉴权失败。 |
|
403 |
没有操作权限。 |
|
500 |
服务内部错误。 |
|
503 |
服务不可用。 |