所有文档

          云服务器 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
              }
             ]
          }  
          上一篇
          删除快照
          下一篇
          自动快照策略相关接口