调用CreateSnapshot为指定的磁盘创建快照。

使用说明

快照是某一时间点磁盘数据状态的备份文件，常用于日常数据备份、服务器数据误操作恢复、网络攻击恢复、制作自定义镜像等场景。

说明 轻量应用服务器创建快照不收取任何费用。

注意事项

  • 单台轻量应用服务器最多可创建3个快照。
  • 一个阿里云账号可创建的快照数量上限为已创建的轻量应用服务器数量的3倍，但最多不超过15个。
  • 如果服务器到期释放，该服务器对应的快照会被清除。
  • 重置系统或更换镜像前创建的快照，在重置系统或更换镜像后会保留但无法支持回滚操作。

QPS限制

本接口的单用户QPS限制为10次/分钟。超过限制，API调用会被限流，这可能会影响您的业务，请合理调用。更多信息，请参见QPS限制。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
RegionId String 是 cn-hangzhou

指定磁盘对应的轻量应用服务器所属的地域ID。
DiskId String 是 d-bp18kjxg9ebrhsgi****

指定的磁盘ID。
SnapshotName String 是 test-SnapshotName

快照名称。长度为2~50个字符，必须以大小字母或中文开头，不能以http://和https://开头。可以包含中文、英文、数字、半角冒号（:）、下划线（_）、点号（.）或者短划线（-）。

ClientToken String 否 123e4567-e89b-12d3-a456-426655440000

保证请求幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken只支持ASCII字符，且不能超过64个字符。更多信息，请参见如何保证幂等性。

Action String 是 CreateSnapshot

系统规定参数。取值：CreateSnapshot。

返回数据

名称 类型 示例值 描述
SnapshotId String s-bp16oazlsold4dks****

快照ID。
RequestId String 20758A-585D-4A41-A9B2-28DA8F4F534F

请求ID。

示例

请求示例

http(s)://swas.cn-hangzhou.aliyuncs.com/?RegionId=cn-hangzhou
&DiskId=d-bp18kjxg9ebrhsgi****
&SnapshotName=test-SnapshotName
&ClientToken=123e4567-e89b-12d3-a456-426655440000	
&Action=CreateSnapshot
&公共请求参数

正常返回示例

XML格式 

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateSnapshotResponse>
    <SnapshotId>s-bp16oazlsold4dks****</SnapshotId>
    <RequestId>20758A-585D-4A41-A9B2-28DA8F4F534F	</RequestId>
</CreateSnapshotResponse>

JSON格式 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "SnapshotId" : "s-bp16oazlsold4dks****",
  "RequestId" : "20758A-585D-4A41-A9B2-28DA8F4F534F\t"
}

错误码

HttpCode 错误码 错误信息 描述
400 InvalidRemark.ValueNotSupported The specified parameter Remark is invalid. 指定的快照备注不合法。
400 InvalidRemark.Duplicate The specified Remark already exists. 指定的快照备注已存在。
400 IncorrectStatus The state of the disk or instance does not currently support snapshot creation. 磁盘或实例的状态目前不支持创建快照。
400 InvalidSnapshotName.ValueNotSupported The specified SnapshotName is invalid. 指定的快照名称不合法。
400 InvalidSnapshotName.Duplicate The specified SnapshotName already exists. 指定的快照名称已存在。
403 SnapshotLimitExceed The maximum number of snapshots in an instance is exceeded. 快照总数超过实例限制。
403 IncorrectDiskStatus.CreatingSnapshot A snapshot is being created in the specified disk. Please try again later. 当前磁盘有创建中的快照，请您等待创建完成再试。
404 InvalidDiskId.NotFound The specified DiskId does not exist. 指定的磁盘不存在，请您检查磁盘ID是否正确。
500 InternalError An error occurred while processing your request. 内部错误，请重试。如果多次尝试失败，请提交工单。

访问错误中心查看更多错误码。