edit-icon download-icon

ResetDisk

最終更新日: Feb 28, 2019

ディスクスナップショットの 1 つを使用して、ディスクを指定されたディスク状態にロールバックします。

説明

このインターフェイスを呼び出すときは、次の点を考慮してください。

  • ディスクの状態はIn_Useでなければなりません。

  • 指定されたディスクが接続されているECSインスタンスのステータスは、「Stopped」でなければなりません。

  • 指定されたSnapshotIdは、ディスク(DiskId)履歴スナップショットの1つでなければなりません。

  • 指定されたインスタンスが locked の場合、インスタンスのOperationLocks'LockReason':"security"にすることはできません。

リクエストパラメーター

名前 必須かどうか 説明
Action String はい このインタフェースの名前。値: ResetDisk
DiskId String はい 指定されたディスクデバイスの ID
SnapshotId String はい ロールバックされるディスクのスナップショット ID

リターンパラメーター

すべてはパブリックリターンパラメーターです。詳細については、「パブリックリターンパラメーター」を参照してください。

リクエストの例

  1. https://ecs.aliyuncs.com/?Action=ResetDisk
  2. &DiskId= d-23jbf2v5m
  3. &SnapshotId=s-snapshot1
  4. &<Public Request Parameters>

戻り値の例

XML 形式

  1. <ResetDiskResponse>
  2. <RequestId>F3CD6886-D8D0-4FEE-B93E-1B73239673DE</RequestId>
  3. </ResetDiskResponse>

JSON 形式

  1. {
  2. "RequestId":"F3CD6886-D8D0-4FEE-B93E-1B73239673DE"
  3. }

エラーコード

このインタフェースに固有のエラーコードは次のとおりです。 詳細については、API エラーコードセンターをご参照ください。

エラーコード 説明 HTTP ステータスコード 意味
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 指定されたスナップショットは完了していません。