指定されたインスタンスからクラウドディスクをデタッチします。ディスクカテゴリには、基本クラウドディスク、効率クラウドディスク、クラウド SSD ディスクがあります。
指定されたインスタンスからクラウドディスクを取り外します。このインターフェイスを呼び出すときは、次の点を考慮してください。
-
取り外す予定のクラウドディスクは、次の条件を満たす必要があります。
-
クラウドディスクの
Portable
属性はTrue
でなければなりません。 - 指定されたクラウドディスクの状態は
In_Use
でなければなりません。 - 指定されたインスタンスの状態は、「実行中」または「停止中」でなければなりません。
-
指定されたインスタンスが locked の場合、そのインスタンスの
OperationLocks
は`LockReason ':" security "
になることはできません。 -
クラウドディスクがデタッチされた後、ターゲットクラウドディスクの
DeleteWithInstance
属性はfasle
に自動的に設定されます。 -
DetachDisk
のアクションは非同期です。アクションが完了するまで数分待ってから、約1分かかります。
リクエストパラメーター
Action | String | はい | このインターフェイスの名前。値: DetachDisk |
InstanceId | String | はい | 対象 ECS の ID |
DiskId | String | はい | ディスクの ID |
リターンパラメーター
すべてはパブリックリターンパラメーターです。詳細については、「パブリックリターンパラメーター」を参照してください。
例
リクエストの例
https://ecs.aliyuncs.com/?action=DetachDisk
&InstanceId=i-23jggx34b
&DiskId=d-23jbf2v5m
&<Public Request Parameters>
戻り値の例
XML 形式
<DetachDiskResponse>
<RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
</DetachDiskResponse>
JSON 形式
{
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}
エラーコード
このインタフェースに固有のエラーコードは次のとおりです。 詳細については、API エラーコードセンターをご参照ください。
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 | 指定されたインスタンスは存在しません。 |