edit-icon download-icon

DetachDisk

最終更新日: Aug 01, 2018

指定されたインスタンスからクラウドディスクをデタッチします。ディスクカテゴリには、基本クラウドディスク、効率クラウドディスク、クラウド SSD ディスクがあります。

説明

指定されたインスタンスからクラウドディスクを取り外します。このインターフェイスを呼び出すときは、次の点を考慮してください。

  • 取り外す予定のクラウドディスクは、次の条件を満たす必要があります。

  • クラウドディスクの Portable 属性は True でなければなりません。

  • 指定されたクラウドディスクの状態は In_Use でなければなりません。
  • 指定されたインスタンスの状態は、「実行中」または「停止中」でなければなりません。
  • 指定されたインスタンスが locked の場合、そのインスタンスの OperationLocks`LockReason ':" security " になることはできません。

  • クラウドディスクがデタッチされた後、ターゲットクラウドディスクの DeleteWithInstance 属性は fasle に自動的に設定されます。

  • DetachDisk のアクションは非同期です。アクションが完了するまで数分待ってから、約1分かかります。

リクエストパラメーター

名前 必須かどうか 説明
Action String はい このインターフェイスの名前。値: DetachDisk
InstanceId String はい 対象 ECS の ID
DiskId String はい ディスクの ID

リターンパラメーター

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

リクエストの例

  1. https://ecs.aliyuncs.com/?action=DetachDisk
  2. &InstanceId=i-23jggx34b
  3. &DiskId=d-23jbf2v5m
  4. &<Public Request Parameters>

戻り値の例

XML 形式

  1. <DetachDiskResponse>
  2. <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
  3. </DetachDiskResponse>

JSON 形式

  1. {
  2. "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
  3. }

エラーコード

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

エラーコード 説明 HTTP ステータスコード 意味
MissingParameter このリクエストの処理に必須の入力パラメーター “InstanceId” が指定されていません。 400 InstanceId が指定されていません。
MissingParameter このリクエストの処理に必須の入力パラメーター “DiskId” が指定されていません。 400 DiskId が指定されていません。
DependencyViolation 指定されたディスクは指定されたインスタンスでアタッチされていません。 403 指定されたディスクは指定されたインスタンスでアタッチされていません。
DiskNotPortable 指定されたディスクはポータブルディスクではありません。 403 指定されたディスクはデタッチできません。
DiskTypeViolation 指定されたディスクはシステムディスクであり、操作をサポートできません。 403 指定されたディスクはシステムディスクであり、デタッチできません。
IncorrectDiskStatus 現在のディスクステータスはこの操作をサポートしていません。 403 ディスクのステータスがIn_Useでなければなりません。
InstanceLockedForSecurity インスタンスはセキュリティ上の理由によりロックされています。 403 指定されたインスタンスには安全ロックがあります。
InvalidDiskId.NotFound 指定されたディスクは存在しません。 404 指定されたディスクは存在しません。
InvalidInstanceId.NotFound 指定されたインスタンスは存在しません。 404 指定されたインスタンスは存在しません。