查询快照列表
2019年08月12日

接口描述

请求路径:https://open.didiyunapi.com/dicloud/i/storage/snapshot/list

请求方法:POST

输入参数

参数名称 必选 类型 描述
regionId string 地域id
zoneId string 查询可用区id
start int 查询SNAP列表起始index,从0开始
limit int 查询SNAP元素数量
simplify bool 是否简化输出
condition SNAPCondition 查询SNAP条件

SNAPCondition:

参数名称 必选 类型 描述
dc2Uuid string 查询此uuid的DC2的根盘及数据盘快照
ebsUuid string 查询此uuid的EBS的快照
snapName string 查询快照的名称,模糊匹配

输出参数

参数名称 类型 描述
errno int 错误码
errmsg string 请求错误说明
requestId string 请求唯一标识
data array<SNAPResponse> 请求返回数据

SNAPResponse:

参数名称 类型 描述
job Job 此EIP正在进行的任务,若无任务则没有此字段
snapUuid string SNAP唯一标识
name string SNAP名称
canBeReverted bool 是否可回滚
isGeneral bool 是否是通用系列(e1,g1,g2)DC2快照(通用系列DC2快照目前只支持用于创建通用系列DC2)
createTime int64 SNAP创建时间
updateTime int64 SNAP 更新时间
size int64 SNAP大小
volumeSize int64 SNAP源盘大小
type string SNAP类型,为"Root"为系统盘快照,为"Data"为数据盘快照,只有系统盘快照可以用于创建新的DC2
dc2 DC2 与SNAP关联的DC2信息,没有DC2则没有该字段
ebs EBS 与SNAP关联的EBS信息,没有EBS则没有该字段
region Region region与zone的信息

DC2:

参数名称 类型 描述
dc2Uuid string DC2唯一标识
name string DC2名称

EBS:

参数名称 类型 描述
ebsUuid string EBS唯一标识
name string EBS名称
type string EBS类型,"HDD"、"HE"或"SSD"

错误码

错误码 说明
0 请求成功
41017 查询SNAP信息失败

示例

请求:
curl -X POST https://open.didiyunapi.com/dicloud/i/storage/snapshot/list \
  -H 'authorization: Bearer 9a609744ad675e8fbfcdbf14511b24e6ddd6b427b4d256969534a81d0773f4d7' \
  -H 'content-type: application/json' \
  -d '{    
    "regionId":"gz",
    "start":0,
    "limit":10,
    "condition":{"snapName":"test"}
}'
输出:
{
    "errno": 0,
    "errmsg": "ok",
    "data": [
        {
            "attr": "User",
            "canBeReverted": true,
            "createTime": 1539761242000,
            "dc2": {
                "dc2Uuid": "b8bf159d2ce258f98b27aedafcaadc91",
                "name": "1CPU-1GMEM-20GDISK"
            },
            "imgScenes": [
                "base"
            ],
            "imgUuid": "c246f4034faa4313bc4c5709e81e4497",
            "isGeneral": false,
            "name": "test",
            "region": {
                "id": "gz",
                "name": "广州",
                "zone": {
                    "id": "gz01",
                    "name": "广州一区"
                }
            },
            "size": 2253979648,
            "snapUuid": "5e424b25acec5a819cedd56e813416ae",
            "type": "Root",
            "updateTime": 1539761268000,
            "volumeSize": 21474836480
        }
    ],
    "requestId": "0a60538a5bc6e4eb2d3f43f5810447b0"
}

项搜索结果

    空空如也
    没有找到您要搜索的内容,请直接拨打服务热线400-0590-666