本接口用于刪除或者釋放一臺按量付費實例或者到期的包年包月實例，支持通過參數設置決定云盤是否釋放或轉換為按量付費保留。
接口說明
警告
釋放實例后，實例所使用的物理資源都被回收，相關數據全部丟失且不可恢復。
釋放實例時，云盤的手動快照會被保留，實例上掛載的云盤和自動快照是否釋放取決于創建時的參數設置。釋放實例之前，您可以通過 DescribeDisks 查詢實例上掛載的云盤和自動快照的相關參數設置：
DeleteWithInstance=false，云盤會被轉換成按量付費云盤而保留下來，否則會隨實例被釋放。DeleteAutoSnapshot=false，自動快照被保留，否則會隨實例被釋放。
注意 被安全鎖定的實例，即使云盤的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 | 否 | 是否強制釋放運行中（
默認值：false。 警告 強制釋放相當于斷電，實例內存以及存儲中的臨時數據都會被擦除，無法恢復。 | false |
| TerminateSubscription | boolean | 否 | 是否釋放已到期的包年包月實例。
默認值：false。 | false |
| DryRun | boolean | 否 | 是否只預檢此次請求。取值范圍：
| false |
返回參數
示例
正常返回示例
JSON格式
{
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}錯誤碼
| HTTP status code | 錯誤碼 | 錯誤信息 | 描述 |
|---|---|---|---|
| 400 | DependencyViolation.SLBConfiguring | Specified operation is denied as your instance is using by another product. | 實例被 SLB 引用，且 SLB 正在配置。 |
| 400 | DependencyViolation.RouteEntry | Specified instance is used by route entry. | 當前專有網絡 VPC 還存在未刪除的自定義路由規則，刪除失敗。 |
| 400 | InvalidParameter | The input parameter InstanceId is invalid. | 指定的 InstanceId 不合法，請您檢查 InstanceId 是否正確，且存在。 |
| 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 | IncorrectInstanceStatus | The specified instance is still attached by volumes. | 指定的實例上存在數據卷。 |
| 403 | InvalidOperation.DeletionProtection | %s | 該操作無效，請先取消該實例的釋放保護。 |
| 403 | InvalidOperation.DeletionProtection | The operation is not allowed due to deletion protection. | 實例開啟了釋放保護，因此不能進行此操作 |
| 403 | InvalidOperation.EniLinked | %s | 實例的當前彈性網卡關聯了其他彈性網卡，導致操作無效。需要解除關聯后才能從實例分離。 |
| 404 | InvalidInstanceId.NotFound | The specified InstanceId does not exist. | 指定的InstanceId不存在。 |
| 500 | InternalError | The request processing has failed due to some unknown error. | 內部錯誤，請重試。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
| 變更時間 | 變更內容概要 | 操作 |
|---|---|---|
| 2024-02-01 | OpenAPI 錯誤碼發生變更、OpenAPI 入參發生變更 | 查看變更詳情 |
| 2023-07-17 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |