创建快照
所有文档

          云服务器 BCC

          创建快照

          该接口用于从指定的磁盘创建快照,支持创建系统盘快照和CDS磁盘快照。

          • 创建系统盘快照时,实例的状态必须为 Running 或 Stopped 此操作才能正常完成。
          • 创建CDS磁盘快照时,磁盘的状态需要为InUse(使用中)或 Available(待挂载)此操作才能正常完成。
          • 可创建快照数量的配额取决于账号下拥有的磁盘总数,当前最多可同时创建n*8个快照,n为总磁盘(CDS云磁盘+系统盘)数量。

          请求结构

          POST /v{version}/snapshot?clientToken={clientToken} HTTP/1.1
          Host: bcc.bj.baidubce.com
          Authorization: authorization string
          
          {
          	"volumeId":volumeId,
              "snapshotName": snapshotName,
          	"desc" : create snapshot
          }

          请求头域

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

          请求参数

          参数名称 类型 是否必需 参数位置 描述
          version String URL参数 API版本号
          clientToken String Query参数 幂等性Token,是一个长度不超过64位的ASCII字符串,详见ClientToken幂等性
          volumeId String Request Body参数 用于创建快照的磁盘ID,系统盘则为实例ID
          snapshotName String Request Body参数 快照名称,支持大小写字母、数字、中文以及-_ /.特殊字符,必须以字母开头,长度1-65。
          desc String Request Body参数 快照描述信息,选填

          返回头域

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

          返回参数

          参数名称 类型 描述
          snapshotId String 已创建的快照ID

          错误码

          错误码 错误描述 HTTP状态码 中文解释
          BadRequest Bad request parameters or illegal request. 400 请求参数无效
          Snapshot.SnapshotNameInvalid snapshot name is invalid. 400 名称非法
          Instance.SnapshotLimitExceeded The number of snapshot will exceed the quota limit. 413 快照超出额度

          请求示例

          POST /v2/snapshot?clientToken=be31b98c-5e41-4838-9830-9be700de5a20 HTTP/1.1
          Host: bcc.bj.baidubce.com
          Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
          
          {
              "volumeId": "v-nky7qeom",
              "snapshotName": "example-001"
          }

          返回示例

          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
          
          {
              "snapshotId" : "s-6r3dam6F"
          }
          上一篇
          镜像相关接口
          下一篇
          查询快照列表