DeleteInstance - Elastic Compute Service - Alibaba Cloud ドキュメントセンター

指定された ECS インスタンスを削除またはリリースします。

操作説明

警告インスタンスがリリースされると、そのインスタンスが使用していたすべての物理リソースが回収されます。関連するすべてのデータは完全に失われ、復元できません。

クラウドディスクの手動スナップショットは保持され、引き続き課金されます。 DeleteSnapshot を呼び出して削除できます。
インスタンスにアタッチされたクラウドディスクと自動スナップショットがリリースされるかどうかは、作成時に指定されたパラメータ設定によって異なります。インスタンスをリリースする前に、 DescribeDisks および ModifyDiskAttribute を呼び出して、関連するパラメータ設定をクエリおよび変更できます:
- DeleteWithInstance=false の場合、クラウドディスクは従量課金クラウドディスクに変換されて保持されます。それ以外の場合、クラウドディスクはインスタンスとともにリリースされます。
- DeleteAutoSnapshot=false の場合、自動スナップショットは保持されます。それ以外の場合、インスタンスとともにリリースされます。
Elastic IP アドレス (EIP) はインスタンスとともにリリースされません。 ReleaseEipAddress を呼び出してリリースできます。
重要セキュリティロック済みのインスタンスの場合、クラウドディスクの DeleteWithInstance パラメーターが false にセットされていても、この属性は無視され、クラウドディスクはインスタンスとともにリリースされます。
.

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。
API：アクションを具体的に実行するための API。
アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。
リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。
- リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。
- リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。
条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。
依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

ecs:DeleteInstance

delete

*Instance

acs:ecs:{#regionId}:{#accountId}:instance/{#instanceId}

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
InstanceId	string	必須	インスタンス ID	i-bp1g6zv0ce8oghu7****
Force	boolean	任意	実行中 (`Running`) のインスタンスを強制的にリリースするかどうかを指定します。 true: 実行中 (`Running`) のインスタンスを強制的にリリースします。 false: 通常の方法でインスタンスをリリースします。インスタンスは停止 (`Stopped`) 状態である必要があります。デフォルト値: false。警告強制リリースは電源オフに相当します。インスタンスのメモリおよびストレージ内の一時データは消去され、復元できません。 .	false
ForceStop	boolean	任意	実行中 (`Running`) のインスタンスをリリースする際に、強制シャットダウンポリシーを使用するかどうかを指定します。このパラメーターは `Force=true` の場合にのみ効果があります。有効な値: true: インスタンスを強制的にシャットダウンしてリリースします。これは通常の電源オフ操作に相当します。インスタンスは直接リソースリリースプロセスに入ります。警告強制リリースは電源オフに相当します。インスタンスのメモリおよびストレージ内の一時データは消去され、復元できません。 false: インスタンスがリリースされる前に、システムは優先的に標準シャットダウンプロセスを実行します。このモードではインスタンスのリリースに数分かかります。オペレーティングシステムのシャットダウン中にサービスドレイニングアクションを設定して、ビジネスシステムのノイズを軽減できます。デフォルト値: true。	true
TerminateSubscription	boolean	任意	期限切れのサブスクリプションインスタンスをリリースするかどうかを指定します。 true: インスタンスをリリースします。 false: インスタンスをリリースしません。デフォルト値: false。	false
DryRun	boolean	任意	ドライランのみを実行するかどうかを指定します。有効な値: true: インスタンスをリリースせずにチェックリクエストを送信します。システムは、必須パラメーターが指定されているか、リクエストの形式が有効か、ビジネス要件が満たされているか、ECS リソースが十分かを確認します。チェックが失敗した場合、対応するエラーが返されます。チェックが成功した場合、エラーコード `DryRunOperation` が返されます。 false (デフォルト): 通常のリクエストを送信します。リクエストがチェックに合格した後、インスタンスは直接削除されます。	false

レスポンスフィールド

フィールド	型	説明	例
	object
RequestId	string	リクエスト ID	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

例

成功レスポンス

JSONJSON

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

エラーレスポンス

JSONJSON

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

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ
400	DependencyViolation.SLBConfiguring	Specified operation is denied as your instance is using by another product.
400	DependencyViolation.RouteEntry	Specified instance is used by route entry.
400	InvalidParameter	The input parameter InstanceId is invalid.
500	InternalError	The request processing has failed due to some unknown error.
403	IncorrectInstanceStatus	The current status of the resource does not support this operation.
403	InstanceLockedForSecurity	The specified operation is denied as your instance is locked for security reasons.
403	ChargeTypeViolation	The operation is not permitted due to charge type of the instance.
403	IncorrectInstanceStatus.Initializing	The specified instance status does not support this operation.
403	InvalidOperation.DeletionProtection	%s
403	InvalidOperation.EniLinked	%s
403	OperationDenied.SystemInstanceNotSupport	The system instance does not support the %s operation because %s.
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。