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

複数の従量課金インスタンスまたは期限切れのサブスクリプションインスタンスをバッチで削除またはリリースします。パラメーターを使用して、クラウドディスクをリリースするか、従量課金ディスクに変換して保持するかを指定できます。

操作説明

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

クラウドディスクの手動スナップショットは保持され、引き続き課金されます。 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:DeleteInstances

delete

*Instance

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

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
DryRun	boolean	任意	実際のリクエストを実行せずに、ドライランのみを実行するかどうかを指定します。 true: リソースステータスをクエリせずにチェックリクエストを送信します。チェック項目には、AccessKey ペアが有効かどうか、Resource Access Management (RAM) ユーザーの権限付与が付与されているかどうか、必須パラメーターが指定されているかどうかが含まれます。チェックが失敗した場合、対応するエラーが返されます。チェックが成功した場合、DRYRUN.SUCCESS エラーコードが返されます。 false: 通常のリクエストを送信します。チェックが成功すると、2xx HTTP 状態コードが返され、リソースステータスが直接クエリされます。デフォルト値: false。	false
Force	boolean	任意	実行中 (`Running`) 状態のインスタンスを強制的にリリースするかどうかを指定します。 true: 実行中 (`Running`) 状態の ECS インスタンスを強制的にリリースします。 false: 停止済み (`Stopped`) 状態の ECS インスタンスのみをリリースします。デフォルト値: false。警告強制リリースは ECS インスタンスの電源オフに相当します。メモリ内のすべてのデータとストレージ内の一時データは消去され、復元できません。 .	false
ForceStop	boolean	任意	インスタンスが実行中 (`Running`) 状態の場合、リリース前にインスタンスを強制的にシャットダウンするかどうかを指定します。このパラメーターは `Force=true` の場合にのみ有効です。有効な値: true: インスタンスを強制的にシャットダウンしてリリースします。これは電源オフ操作に相当します。インスタンスは直接リソースリリースプロセスに入ります。警告強制リリースはインスタンスの電源オフに相当します。メモリ内のすべてのデータとストレージ内の一時データは消去され、復元できません。 false: インスタンスをリリースする前に標準シャットダウンを実行します。このモードではリリースプロセスに数分かかります。オペレーティングシステムのシャットダウン中にサービスドレイニングアクションを設定して、ビジネスシステムへのノイズを軽減できます。デフォルト値: true。	true
TerminateSubscription	boolean	任意	期限切れのサブスクリプションインスタンスをリリースするかどうかを指定します。 true: インスタンスをリリースします。 false: インスタンスをリリースしません。デフォルト値: false。	false
ClientToken	string	任意	リクエストのべき等性を確保するために使用されるクライアントトークン。クライアントを使用してトークンを生成できますが、異なるリクエスト間でトークンが一意であることを確認してください。ClientToken の値には ASCII 文字のみを含めることができ、64 文字を超えることはできません。詳細については、べき等性の確保方法を参照してください。	123e4567-e89b-12d3-a456-426655440000
RegionId	string	必須	インスタンスのリージョン ID。 DescribeRegions を呼び出して、最新のリージョンリストをクエリできます。	cn-hangzhou
InstanceId	array	必須	インスタンス ID の配列。配列の長さ: 1〜100。	i-bp1g6zv0ce8oghu7****
	string	任意	インスタンス ID	i-bp1g6zv0ce8oghu7****

レスポンスフィールド

フィールド	型	説明	例
	object
RequestId	string	リクエスト ID	7B7813C6-57BF-41XX-B12B-F172F65A6046

例

成功レスポンス

JSONJSON

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

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ
400	InvalidParameter.CrossRegionNotSupport	Instances of multiple regions not support.
400	DRYRUN.SUCCESS	This request is a dryrun request with successful result.
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.
500	InvalidParameter	Invalid parameters.
500	InternalError	The request processing has failed due to some unknown error.
403	InvalidParameter.TooManyInstanceIds	Instance ids cannot be more than 100.
403	InvalidInstanceIds.ValueNotSupported	The specified instanceIds is not valid.
403	InvalidOperation.DeletionProtection	The operation is not allowed due to deletion protection.
403	ChargeTypeViolation	%s
403	IncorrectInstanceStatus.Initializing	%s
403	InvalidOperation.EniLinked	%s
403	IncorrectInstanceStatus	%s
403	InstanceLockedForSecurity	The specified operation is denied as your instance is locked for security reasons.
403	OperationDenied.SystemInstanceNotSupport	The system instance does not support the %s operation because %s.
404	InvalidInstanceIds.NotFound	The specified InstanceIds does not exist.
404	InvalidInstanceId.NotFound	%s

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

変更履歴

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