DeleteInstances - Elastic Compute Service

本介面用於批量刪除或者釋放按量付費實例或者到期的包年包月實例，支援透過參數設定決定雲盤是否釋放或轉換為按量付費保留。

介面說明

警告釋放實例後，實例所使用的物理資源會被回收，相關資料全部丟失且不可恢復。

雲盤的手動快照會被保留並繼續計費，您可以透過 DeleteSnapshot 刪除。
實例上掛載的雲盤和自動快照是否被釋放取決於建立時的參數設定。釋放實例之前，您可以透過 DescribeDisks 、 ModifyDiskAttribute 查詢和修改相關參數設定：
- DeleteWithInstance=false，雲盤會被轉換成按量付費雲盤而保留下來，否則會隨實例被釋放。
- DeleteAutoSnapshot=false，自動快照被保留，否則會隨實例被釋放。
彈性公網 IP（EIP）不會隨實例被釋放，您可以透過 ReleaseEipAddress 釋放。
重要被安全鎖定的實例，即使雲盤的DeleteWithInstance參數設定為false，釋放實例時也會忽略這個屬性而釋放雲盤。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

ecs:DeleteInstances

delete

*Instance

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

無

請求參數

名稱	類型	必填	描述	樣本值
DryRun	boolean	否	是否只預檢此次請求。 true：發送檢查請求，不會查詢資源狀況。檢查項包括 AccessKey 是否有效、RAM 使用者的授權情況和是否填寫了必需參數。如果檢查不通過，則返回對應錯誤。如果檢查通過，會返回錯誤碼 DRYRUN.SUCCESS。 false：發送正常請求，通過檢查後返回 2XX HTTP 狀態碼並直接查詢資源狀況。預設值：false。	false
Force	boolean	否	是否強制釋放運行中（`Running`）的 ECS 實例。 true：強制釋放運行中（`Running`）的實例。 false：正常釋放實例，此時實例必須處於已停止（`Stopped`）狀態。預設值：false。警告強制釋放相當於斷電，實例記憶體以及儲存中的臨時資料都會被擦除，無法恢復。	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

樣本

正常返回樣本

JSON格式

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

錯誤碼

HTTP status code	錯誤碼	錯誤資訊
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

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊，參考變更詳情。