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

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String CreateSnapshot

系统规定参数。取值:CreateSnapshot

DiskId String d-bp18kjxg9ebrhsgi****

指定的磁盘ID。

RegionId String cn-hangzhou

指定磁盘对应的轻量应用服务器所属的地域ID。

SnapshotName String test-SnapshotName

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

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

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

返回数据

名称 类型 示例值 描述
RequestId String 20758A-585D-4A41-A9B2-28DA8F4F534F

请求ID。

SnapshotId String s-bp16oazlsold4dks****

快照ID。

示例

请求示例

https://swas.cn-hangzhou.aliyuncs.com/?Action=CreateSnapshot
&DiskId=d-bp18kjxg9ebrhsgi****
&SnapshotName=test-SnapshotName
&<公共请求参数>

正常返回示例

XML格式

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

JSON格式

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

错误码

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

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