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

説明

  • インスタンスが解放されると、そのインスタンスで使用されていたすべての物理リソースが回収されます。 データは消去され、復元できません。 DeleteWithInstance=True値を持つアタッチされたデータディスクは解放されますが、それらの自動スナップショットは保持されます。 これはDeleteAutoSnapshotの値に依存します。 値がDeleteAutoSnapshot=falseの場合、自動スナップショットは保持されます。 値がDeleteAutoSnapshot=trueの場合、自動スナップショットが解放されます。
  • Security Control が有効で、OperationLocksタグが"LockReason" : "security"として付けられた ECS インスタンスの場合、アタッチされたデータディスクのDeleteWithInstanceがFalseに設定されていても、この値は無視され、アタッチされたデータディスクは解放されます。

デバッグ

API Explorer でデバッグを実行できます。 API Explorer で各種操作を実行して API の使用を簡素化できます。 たとえば、API の取得、API の呼び出し、SDK のサンプルコードの動的な生成ができます。

リクエストパラメーター

名前 データ型 必須/省略可能 例 説明
InstanceId String 必須 i-instance1

インスタンスの ID。

Action String 省略可能 DeleteInstance

実行する操作。 値を DeleteInstance に設定します。

Force Boolean 省略可能 false

実行中（Running）状態のインスタンスを強制的に解放するかどうかを示します。 既定値：false 有効値：

  • true：実行中（Running）状態のインスタンスを強制的に解放します。 この値を選択すると、インスタンスのメモリとストレージの一時データが消去され、復元できなくなります。
  • false：停止（Stopped）状態にあるインスタンスに対してのみ、この値を選択できます。
OwnerAccount String 省略可能 ECSforCloud@Alibaba.com

RAM ユーザーのログインネーム。

TerminateSubscription Boolean 省略可能 false

期限切れのサブスクリプションインスタンスを解放するかどうかを示します。 デフォルト値：false。

レスポンスパラメーター

名前 データ型 例 説明
RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

リクエスト ID 。 API 操作の結果にかかわらず、各 API リクエストに対してシステムから固有の RequestId が返されます。

例

リクエストの例


https://ecs.aliyuncs.com/?Action=DeleteInstance
&InstanceId=i-instance1 
&Force=false
&TerminateSubscription=false
&<Common request parameters>

通常のレスポンスの例

XML 形式 

<DeleteInstanceResponse>
  <RequestId>928E2273-5715-46B9-A730-238DC996A533</RequestId>
</DeleteInstanceResponse>

JSON 形式 

{
	"RequestId":"928E2273-5715-46B9-A730-238DC996A533"
}

エラーコード

HTTP ステータスコード エラーコード エラーメッセージ 説明
403 IncorrectInstanceStatus The current status of the resource does not support this operation. リソースの現在のステータスで該当の操作がサポートされていない場合に返されるエラーメッセージ。
403 ChargeTypeViolation The operation is not permitted due to charge type of the instance. 該当の課金方法が選択されていると、操作が実行せきない場合に返されるエラーメッセージ。
400 DependencyViolation.RouteEntry Specified instance is used by route entry. VPC にまだカスタムルーティングルールが存在する場合に返されるエラーメッセージ。
400 InvalidParameter The input parameter InstanceId is invalid. 指定された InstanceId が無効な場合に表示されるエラーメッセージ。 InstanceIdが存在しているかどうか、そして正しいかどうかをご確認ください。
403 IncorrectInstanceStatus.Initializing The specified instance status does not support this operation. インスタンスが初期化されており、解放できないときに返されるエラーメッセージ。 しばらくしてからもう一度お試しください。
403 IncorrectInstanceStatus The specified instance is still attached by volumes. 指定されたインスタンスタイプが存在しない場合に表示されるエラーメッセージ。
403 InvalidOperation.DeletionProtection %s インスタンスの解放保護が有効になっているときに返されるエラーメッセージ。
403 InvalidOperation.NotInWhiteList %s パラメーターがホワイトリストにない場合に返されるエラーメッセージ。

エラーコードの表示