このAPIを呼び出して、1つ以上の従量課金インスタンスまたは期限切れのサブスクリプションインスタンスをリリースできます。

説明

  • インスタンスがリリースされると、インスタンスで使用されているすべての物理リソースがリサイクルされます。 関連するデータは消去され、回復できません。
  • インスタンスに接続されたディスク:
    • DeleteWithInstanceがfalseに設定されているディスクは、従量課金ディスクとして保持されます。
    • DeleteWithInstanceがtrueに設定されているディスクは、インスタンスとともにリリースされます。
    • DeleteAutoSnapshotがfalseに設定されているディスクの場合、自動スナップショットは保持されます。
    • DeleteAutoSnapshotがtrueに設定されているディスクの場合、自動スナップショットはリリースされます。
    • 手動スナップショットは保持されます。
    • If OperationLocksにDescribeInstances応答含まれ "LockReason" : "セキュリティ" ためインスタンス、インスタンスはロックセキュリティ上の理由から。 インスタンスにアタッチされているデータディスクのDeleteWithInstanceがfalseに設定されている場合でも、このパラメーターは無視され、データディスクはインスタンスとともにリリースされます。 詳細については、「セキュリティ上の理由でインスタンスがロックされたときのAPIの動作」をご参照ください。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。 この操作は、OpenAPI Explorer で呼び出すことを推奨します。 OpenAPI Explorer は、さまざまな SDK に対して操作のサンプルコードを動的に生成します。

リクエストパラメーター

パラメーター データ型 必須／任意 例 説明
操作 String 必須 DeleteInstances

実行する操作です。 値をDeleteInstancesに設定します。
<td class="en-UStry align-left colsep-1 rowsep-1"> InstanceId.N </td> RepeatList 必須 i-bp1g6zv0ce8oghu7 ****

リリースするインスタンスNのID。 N: 1 ~ 100の有効値。
RegionId String 必須 cn-hangzhou

インスタンスのリージョンID。 DescribeRegions を呼び出すと、最新のリージョンリストを照会できます。

DryRun Boolean 任意 false

実際にリクエストを行わずに、リクエストの有効性を確認するかどうかを指定します。 規定値: false 設定可能な値は以下のとおりです。

  • true: リクエストの有効性はチェックされますが、リクエストは行われません。 チェック項目には、AccessKeyペアが有効かどうか、RAMユーザーが許可されているかどうか、および必要なパラメーターが設定されているかどうかが含まれます。 確認が失敗した場合、対応するエラーメッセージが返されます。 チェックが成功した場合、DRYRUN.SUCCESSが返されます。
  • false: リクエストの有効性がチェックされます。 チェックが成功すると、2XX HTTPステータスコードが返され、リクエストが行われます。
フォース Boolean 任意 false

インスタンスを実行中 (実行中) 状態で強制リリースするかどうかを指定します。 規定値: false 有効な値:

  • true: インスタンスを実行中 (実行中) 状態で強制的にリリースします。 この動作は、電源オフ動作に相当する。 インスタンスのメモリおよびストレージ内の一時データは消去され、復元できません。
  • false: 通常、インスタンスをリリースします。 この値は、Stopped (Stopped) ステータスのインスタンスに対してのみ有効です。
TerminateSubscription Boolean 任意 false

期限切れのサブスクリプションインスタンスをリリースするかどうかを指定します。

規定値: false
ClientTokend String 任意 123e4567-e89b-12d3-a456-426655440000

リクエストのべき等性を保証するために使用されるクライアントトークン。 クライアントを使用して値を生成できますが、異なるリクエスト間で一意であることを確認する必要があります。 ClientTokenの値にはASCII文字のみを含める必要があり、長さは64文字を超えることはできません。 詳細は、「べき等性を確保する方法」をご参照ください。

レスポンスパラメーター

パラメーター データ型 例 説明
RequestId String 7B7813C6-57BF-41XX-B12B-F172F65A6046

リクエストの ID です。

例

リクエストの例

https://ecs.aliyuncs.com/?Action=DeleteInstances
&InstanceId.1=i-bp1g6zv0ce8oghu7 ****
&Force=false
&<共通リクエストパラメーター>

正常に処理された場合のレスポンス例

XML 形式 

<DeleteInstancesResponse>
      <RequestId>7B7813C6-57BF-41XX-B12B-F172F65A6046</RequestId>
</DeleteInstancesResponse>

JSON 形式 

{
    "RequestId": "7B7813C6-57BF-41XX-B12B-F172F65A6046"
}

エラーコード

HTTP ステータスコード エラーコード エラーメッセージ 説明
403 InvalidOperation.DeletionProtection %s 操作が無効な場合に返されるエラーメッセージ。 最初にインスタンスのリリース保護を無効にします。
403 InvalidOperation.EniLinked %s インスタンスがelastic network Interface (ENI) にバインドされている間、操作がサポートされていない場合に返されるエラーメッセージ。
403 IncorrectInstanceStatus %s 現在のインスタンスのステータスで該当の操作がサポートされていない場合に返されるエラーメッセージ。
500 InternalError 不明なエラーにより、リクエスト処理が失敗しました。 内部エラーが発生した場合に返されるエラーメッセージです。 しばらくしてから再試行します。 問題が解決しない場合、チケットを起票し、サポートセンターへお問い合わせください。
500 InternalError %s 内部エラーが発生した場合に返されるエラーメッセージです。
403 InstanceLockedForSecurity セキュリティ上の理由によりインスタンスがロックされているため、指定された操作は拒否されました。 セキュリティ上の理由によりインスタンスがロックされているため、該当の操作がサポートされていない場合に返されるエラーメッセージ。
400 DependencyViolation.SLBConfiguring インスタンスが別の製品で使用しているため、指定された操作は拒否されます。 インスタンスが構成中のSLBインスタンスによって参照されている場合に返されるエラーメッセージ。
400 DependencyViolation.RouteEntry 指定されたインスタンスはルートエントリで使用されます。 指定されたインスタンスのIPアドレスを含むカスタムルーティングエントリが現在のVPCに存在する場合に返されるエラーメッセージ。

エラーコードの詳細については、「API エラーセンター (API Error Center)」をご参照ください。