DeleteInstance - Elastic Compute Service

刪除或者釋放一台指定的 ECS 執行個體。

介面說明

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

。

雲端硬碟的手動快照會被保留並繼續計費，您可以透過 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: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

樣本

正常返回樣本

JSON格式

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

異常返回樣本

JSON格式

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

錯誤碼

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

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

變更歷史

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