搜索本产品文档关键词
查询快照链列表
所有文档
menu
没有找到结果,请重新输入

云服务器 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
    }
   ]
}  
上一篇
删除快照
下一篇
快照链解绑标签