云服务器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"
    }
    一篇
    镜像相关接口
    一篇
    查询快照列表