1. 接口描述
本接口（CreateSnapshot）用于对指定云硬盘创建快照，此接口会返回新创建快照的 ID，用户可使用此 ID 调用 DescribeSnapshots（查询快照列表） 接口来查询快照创建进度（percent）。快照说明详见 快照作用。
接口请求域名：snapshot.api.qcloud.com
使用限制：
- 只有具有快照能力的云硬盘才能创建快照。云硬盘是否具有快照能力可由 DescribeCbsStorages（查询云硬盘信息） 接口查询，见输出参数中
snapshotAbility字段。 - 可创建快照数量限制见 产品使用限制。
2. 输入参数
以下请求参数列表仅列出了接口请求参数，其它参数见 公共请求参数 页面。
| 参数名称 | 必选 | 类型 | 描述 |
|---|---|---|---|
| storageId | 是 | String | 需要创建快照的云硬盘 ID，可通过 DescribeCbsStorages（查询云硬盘信息） 接口查询 |
| snapshotName | 否 | String | 快照名称，如不传则新快照名称为“未命名” |
3. 输出参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| code | Int | 错误码。0：成功，其他值：失败 |
| message | String | 错误信息 |
| snapshotId | String | 新创建的快照 ID |
4. 错误码表
以下错误码表仅列出了该接口的业务逻辑错误码，更多公共错误码详见 云硬盘错误码。
| 错误代码 | 英文描述 | 错误描述 |
|---|---|---|
| 9003 | InvalidParameter | 参数错误 |
| 16007 | IncorrectInstanceStatus.DiskTypeInvalid | 当前云硬盘不支持此操作 |
| 16026 | IncorrectInstanceStatus.SnapshotNotSupported | 该云硬盘不支持快照功能 |
| 16005 | IncorrectInstanceStatus.DiskBusy | 云硬盘繁忙 |
| 16006 | SnapshotQuotaExceeded | 超过快照限额 |
| 16027 | IncorrectInstanceStatus.CbsCreatingSnapshot | 云硬盘正在创建快照中，请稍后重试 |
5. 示例
输入：
https://snapshot.api.qcloud.com/v2/index.php? <公共请求参数> &Action=CreateSnapshot &storageId=disk-g73hhs4o &snapshotName=mySnap
返回示例如下。从中可以看出，成功创建一个快照，快照 ID 为snap-o7zxxxr3
{
"code":"0",
"message":"",
"snapshotId":"snap-o7zxxxr3"
}
