云服务器BCC

    查询快照列表

    该接口用于查询所有的快照信息,包括系统盘快照和CDS磁盘快照信息。

    请求结构

    GET /v{version}/snapshot?marker={marker}&maxKeys={maxKeys}&volumeId={volumeId} HTTP/1.1
    Host: bcc.bj.baidubce.com
    Authorization: authorization string

    请求头域

    除公共头域外,无其它特殊头域。

    请求参数

    参数名称 类型 是否必需 参数位置 描述
    version String URL参数 API版本号
    marker String Query参数 批量获取列表的查询的起始位置,是一个由系统生成的字符串。
    maxKeys int Query参数 每页包含的最大数量,最大数量通常不超过1000。缺省值为1000
    volumeId String Query参数 通过磁盘ID过滤,系统盘则为实例ID

    返回头域

    除公共头域,无其它特殊头域。

    返回参数

    参数名称 类型 描述
    marker String 标记查询的起始位置
    isTruncated boolean true表示后面还有数据,false表示已经是最后一页。
    nextMarker String 获取下一页所需要传递的marker值。当isTruncated为false时,该域不出现。
    maxKeys int 每页包含的最大数量
    snapshots List<SnapshotModel> 返回的快照列表

    错误码

    无特殊返回错误码

    请求示例

    GET /v2/snapshot?marker=s-6r3dam6F&maxKeys=2 HTTP/1.1
    Host: bcc.bj.baidubce.com
    Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de

    返回示例

    HTTP/1.1 200 OK
    x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
    Date: Wed, 03 Dec 2014 06:42:19 GMT
    Content-Type: application/json;charset=UTF-8
    Server: BWS
    
    {
        "nextMarker": "s-tpxSNbqb",
        "marker": "s-6r3dam6F",
        "maxKeys": 2,
        "snapshots": [
            {
                "id": "s-6r3dam6F",
                "createTime": "2015-07-08T10:22:04Z",
                "name": "snapshot-name",
                "sizeInGB": 5,
                "status": "Available",
                "createMethod": "MANUAL",
                "volumeId": "v-IgJOjBWj",
                "desc": "snapshot-decription"
            },
            {
                "id": "s-UrGLpTYC",
                "createTime": "2015-07-08T10:21:03Z",
                "name": "snapshot-name",
                "sizeInGB": 5,
                "status": "Available",
                "createMethod": "MANUAL",
                "volumeId": "v-IgJOjBWj",
                "desc": "snapshot-decription"
            }
        ],
        "isTruncated": false
    }
    一篇
    创建快照
    一篇
    查询快照详情