ディスクスナップショットの 1 つを使用して、ディスクを指定されたディスク状態にロールバックします。
このインターフェイスを呼び出すときは、次の点を考慮してください。
-
ディスクの状態は
In_Use
でなければなりません。 -
指定されたディスクが接続されているECSインスタンスのステータスは、「Stopped」でなければなりません。
-
指定された
SnapshotId
は、ディスク(DiskId
)履歴スナップショットの1つでなければなりません。 -
指定されたインスタンスが locked の場合、インスタンスの
OperationLocks
は'LockReason':"security"
にすることはできません。
リクエストパラメーター
Action | String | はい | このインタフェースの名前。値: ResetDisk |
DiskId | String | はい | 指定されたディスクデバイスの ID |
SnapshotId | String | はい | ロールバックされるディスクのスナップショット ID |
リターンパラメーター
すべてはパブリックリターンパラメーターです。詳細については、「パブリックリターンパラメーター」を参照してください。
例
リクエストの例
https://ecs.aliyuncs.com/?Action=ResetDisk
&DiskId= d-23jbf2v5m
&SnapshotId=s-snapshot1
&<Public Request Parameters>
戻り値の例
XML 形式
<ResetDiskResponse>
<RequestId>F3CD6886-D8D0-4FEE-B93E-1B73239673DE</RequestId>
</ResetDiskResponse>
JSON 形式
{
"RequestId":"F3CD6886-D8D0-4FEE-B93E-1B73239673DE"
}
エラーコード
このインタフェースに固有のエラーコードは次のとおりです。 詳細については、API エラーコードセンターをご参照ください。
MissingParameter | このリクエストの処理に必須の入力パラメーター “DiskId” が指定されていません。 | 400 | DiskId パラメーターが指定されていません。 |
MissingParameter | このリクエストの処理に必須の入力パラメーター “SnapshotId” が指定されていません。 | 400 | SnapshotId パラメーターが指定されていません。 |
InvalidDiskId.NotFound | 指定されたディスクは存在しません。 | 404 | 指定されたディスクは存在しません。 |
InvalidSnapshotId.NotFound | 指定されたスナップショットIDは存在しません。 | 404 | 指定されたスナップショットIDは存在しません。 |
IncorrectDiskStatus | 現在のディスクステータスはこの操作をサポートしていません。 | 403 | ディスクのステータスが正しくありません。 |
IncorrectInstanceStatus | リソースの現在のステータスはこの操作をサポートしていません。 | 403 | 指定されたインスタンスのステータスが正しくありません。 |
InstanceLockedForSecurity | インスタンスはセキュリティ上の理由によりロックされています。 | 403 | 指定されたインスタンスには安全ロックがあります。 |
InvalidParameter.Mismatch | 指定されたスナップショットは、指定されたディスクから作成されていません。 | 403 | 指定されたスナップショットは、指定されたディスクのスナップショットではありません。 |
InvalidSnapshot.TooOld | snapshotId は 2013 年 7 月 15 日以前に作成されており、初めてデタッチされたディスクから復元できません。 | 403 | 指定されたスナップショットは 2013 年 7 月 15 日またはそれ以前に作成されたため、ディスクをロールバックできません。 |
InstanceExpiredOrInArrears | 前払いインスタンスの期限が切れているか (サブスクリプションの場合)、料金滞納状態 (従量課金の場合) であるため、指定された操作は拒否されます。 | 403 | 指定されたディスクのソーススナップショットは削除されたため、ディスクを再初期化できません。 |
OperationDenied | 指定されたスナップショットは、ResetDisk をサポートしていません。 | 403 | 指定されたスナップショットは、ロールバックに使用できません。 |
InvalidSnapshotId.NotReady | 指定されたスナップショットはまだ完了していません。 | 403 | 指定されたスナップショットは完了していません。 |