调用ResetDisk使用指定的快照回滚磁盘。
接口说明
- 使用快照回滚磁盘时,对应的轻量应用服务器必须为已停止状态。
- 回滚快照会丢失该快照创建之后的增量数据,如有需要请您提前做好数据备份。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | ResetDisk |
系统规定参数。取值:ResetDisk |
DiskId | String | 是 | d-bp14wq0149cpp2xy**** |
待回滚的磁盘ID。 |
RegionId | String | 是 | cn-hangzhou |
快照对应的轻量应用服务器所属的地域ID。 |
SnapshotId | String | 是 | s-bp16oazlsold4dks**** |
快照ID。 |
ClientToken | String | 否 | 123e4567-e89b-12d3-a456-426655440000 |
保证请求幂等性。从您的客户端生成一个参数值,确保不同请求间该参数值唯一。ClientToken只支持ASCII字符,且不能超过64个字符。更多信息,请参见如何保证幂等性。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | 20758A-585D-4A41-A9B2-28DA8F4F534F |
请求ID。 |
示例
请求示例
https://swas.cn-hangzhou.aliyuncs.com/?Action=ResetDisk
&DiskId=d-bp14wq0149cpp2xy****
&SnapshotId=s-bp16oazlsold4dks****
&<公共请求参数>
正常返回示例
XML
格式
<ResetDiskResponse>
<RequestId>20758A-585D-4A41-A9B2-28DA8F4F534F</RequestId>
</ResetDiskResponse>
JSON
格式
{
"RequestId": "20758A-585D-4A41-A9B2-28DA8F4F534F"
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
404 | InvalidDiskId.NotFound | The specified DiskId does not exist. | 指定的磁盘不存在,请您检查磁盘ID是否正确。 |
404 | InvalidSnapshotId.NotFound | The specified SnapshotId does not exist. | 指定的快照不存在,请您检查快照ID是否正确。 |
500 | InternalError | An error occurred while processing your request. | 内部错误,请重试。如果多次尝试失败,请提交工单。 |
403 | IncorrectInstanceStatus.ResetDisk | Rolling back the disk requires the instance to operate in a stopped state. | 回滚磁盘需要实例在停止的状态下进行操作。 |
访问错误中心查看更多错误码。