使用磁碟的曆史快照回滾至某一階段的磁碟狀態。
描述
調用該介面時,您需要注意:
-
磁碟的狀態必須為 使用中(
In_Use
)的狀態。 -
磁碟掛載的執行個體的狀態必須為 已停止(
Stopped
)。 -
指定的參數
SnapshotId
必須是由DiskId
建立的曆史快照。 -
被 安全控制 的 ECS 執行個體的
OperationLocks
中不能標記為"LockReason" : "security"
。
請求參數
名稱 | 類型 | 是否必需 | 描述 |
---|---|---|---|
Action | String | 是 | 系統規定參數。取值:ResetDisk |
DiskId | String | 是 | 指定的磁碟裝置識別碼。 |
SnapshotId | String | 是 | 需要恢複到某一磁碟階段的曆史快照 ID。 |
返回參數
全是公共返回參數。參閱 公共參數
樣本
請求樣本
https://ecs.aliyuncs.com/?Action=ResetDisk
&DiskId=d-23jbf2v5m
&SnapshotId=s-snapshot1
&<公共請求參數>
返回樣本
XML 格式
<ResetDiskResponse>
<RequestId>F3CD6886-D8D0-4FEE-B93E-1B73239673DE</RequestId>
</ResetDiskResponse>
JSON 格式
{
"RequestId":"F3CD6886-D8D0-4FEE-B93E-1B73239673DE"
}
錯誤碼
以下為本介面特有的錯誤碼。更多錯誤碼,請訪問 API 錯誤中心。
錯誤碼 | 錯誤資訊 | HTTP 狀態碼 | 說明 |
---|---|---|---|
DiskCategory.OperationNotSupported | The operation is not supported to the specified disk due to its disk category. | 400 | 指定磁碟的磁碟類型不支援該操作。 |
IncorrectDiskStatus | The current disk status does not support this operation. | 403 | 磁碟的狀態必須為 使用中(In_Use )的狀態。 |
IncorrectInstanceStatus | The current status of the resource does not support this operation. | 403 | 磁碟掛載的執行個體的狀態必須為 已停止(Stopped )。 |
InstanceExpiredOrInArrears | The specified operation is denied as your prepay instance is expired (prepay mode) or in arrears (afterpay mode). | 403 | 您的執行個體已過期或者已欠費。 |
InstanceLockedForSecurity | The instance is locked due to security. | 403 | 指定的執行個體被 安全控制。 |
InvalidAccountStatus.NotEnoughBalance | Your account does not have enough balance. | 403 | 賬戶餘額不足。 |
InvalidAccountStatus.SnapshotServiceUnavailable | Snapshot service has not been opened yet. | 403 | 您暫未開通快照服務,前往 ECS 控制台 開通。 |
InvalidParameter.Mismatch | The specified snapshot is not created from the specified disk. | 403 | 指定的快照不是指定磁碟的曆史快照。 |
InvalidSnapshot.TooOld | The snapshotId is created before 2013-07-15, it cannot be restored since the first time the disk detached. | 403 | 指定的快照建立於 2013 年 7 月 15 日(含)之前,不能用於回滾磁碟。 |
InvalidSnapshotId.NotReady | The specified snapshot has not completed yet. | 403 | 指定的快照還在建立中。 |
OperationDenied | The specified snapshot dees not support ResetDisk. | 403 | 指定的快照不能用於回滾。 |
InvalidDiskId.NotFound | The specified disk does not exist. | 404 | 指定的磁碟不存在。 |
InvalidSnapshotId.NotFound | The specified SnapshotId does not exist. | 404 | 指定的快照不存在。 |