使用磁碟的曆史快照回滾至某一階段的磁碟狀態。

描述

調用該介面時,您需要注意:

  • 磁碟的狀態必須為 使用中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 指定的快照不存在。