云服务器BCC

    查询快照链列表

    该接口用于查询用户的快照链列表信息。

    请求结构

    GET /v{version}/snapshot/chain HTTP/1.1
    Host: bcc.bj.baidubce.com
    Authorization: authorization string

    请求头域

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

    请求参数

    参数名称 类型 是否必需 参数位置 描述
    version String URL参数 API版本号
    orderBy String Query参数 排序属性,可选: chainId(快照链id,默认值),chainSize(快照链大小),volumeSize(磁盘大小)
    order String Query参数 排序方式 可选:asc(正序,默认值), desc(倒序)
    pageSize int Query参数 每页容量,默认值为1000
    pageNo int Query参数 页数,默认值为1
    volumeId String Query参数 磁盘id,该字段非空则只返回这个磁盘的快照链信息

    返回头域

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

    返回参数

    参数名称 类型 描述
    orderBy String 排序属性
    totalCount int 快照链总数
    pageSize int 该页容量
    pageNo int 页数
    isTruncated boolean true表示后面还有数据,false表示已经是最后一页
    snapchains List<SnapchainModel> 快照链信息,由 SnapchainModel 组成的集合

    错误码

    错误码 错误描述 HTTP状态码 中文解释
    BadRequest Bad request parameters or illegal request. 400 请求参数无效
    NoSuchObject The specified object is not found or resource do not exist. 404 资源不存在

    请求示例

    GET /v2/snapshot/chain 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
    
    {
      "orderBy": "chainSize",
      "totalCount": 11,
      "pageSize": 2,
      "pageNo": 1,
      "isTruncated": true,
      "snapchains": [
        {
          "status": "active",
          "chainSize": "20.0",
          "chainId": "sl-IvmGOxPc",
          "instanceId": "i-DRqFcFu8",
          "userId": "dcc4b11a97984b62baa65d4592f4d432",
          "volumeId": "v-IvmGOxPc",
          "volumeSize": 40,
          "manualSnapCount": 1,
          "createTime": "2019-12-23T14:35:07Z",
          "autoSnapCount": 0
        },
        {
          "status": "active",
          "chainSize": "0.0",
          "chainId": "sl-dqH1rplQ",
          "instanceId": "",
          "userId": "dcc4b11a97984b62baa65d4592f4d432",
          "volumeId": "v-dqH1rplQ",
          "volumeSize": 50,
          "manualSnapCount": 1,
          "createTime": "2019-12-23T11:02:16Z",
          "autoSnapCount": 0
        }
       ]
    }  
    上一篇
    删除快照
    下一篇
    自动快照策略相关接口