全部產品
Search
文件中心

Auto Scaling:DetachInstances

更新時間:Sep 10, 2026

從一個伸縮組移出一台或多台ECS執行個體。

介面說明

介面說明

  • 呼叫該介面前,請確保滿足以下條件:

    • 目標伸縮組必須處於啟用(Enable)狀態。

    • 目標伸縮組沒有正在進行的伸縮活動。

      說明

      目標伸縮組沒有正在進行的伸縮活動時,該介面可以繞過冷卻時間(Cooldown)直接觸發伸縮活動。

  • 使用該介面需注意以下事項:

    • 移出 ECS 執行個體、ECI 執行個體或託管執行個體之後,該執行個體可以獨立於伸縮組而單獨存在,您可以呼叫 AttachInstances 介面將 ECS 執行個體、ECI 執行個體或託管執行個體再次添加到其他伸縮組。

    • 呼叫該介面移出一台 ECS 執行個體、ECI 執行個體或託管執行個體並不會停止或釋放該執行個體。

    • 介面成功呼叫後,僅表示彈性伸縮服務接受了該介面呼叫的請求。可以正常觸發伸縮活動,但不能保證伸縮活動執行成功,您需要透過返回的 ScalingActivityId 查看伸縮活動的狀態。

    • 目標伸縮組的 ECS 執行個體、ECI 執行個體或託管執行個體數量減去當前移出的 ECS 執行個體、ECI 執行個體或託管執行個體數量不能小於伸縮組最小執行個體數(MinSize),否則會報錯。

調試

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

調試

授權資訊

當前API暫無授權資訊透出。

請求參數

名稱

類型

必填

描述

樣本值

ScalingGroupId

string

伸縮組的 ID。

asg-bp1igpak5ft1flyp****

DecreaseDesiredCapacity

boolean

是否修改期望執行個體數。取值範圍:

  • true:ECS 執行個體、ECI 執行個體或託管執行個體移出伸縮組後,期望執行個體數也減少相應數量。

  • false:ECS 執行個體、ECI 執行個體或託管移出伸縮組後,期望執行個體數不會變化。

預設值:true。

true

IgnoreInvalidInstance

boolean

從伸縮組移出一批執行個體時,是否忽略其中無效執行個體。取值範圍:

  • true:從伸縮組中移出一批執行個體時會忽略其中的無效執行個體。

    如果一批執行個體中存在無效執行個體(例如執行個體狀態為加入中),並且有效的執行個體被成功移出時,則伸縮活動執行狀態顯示為警告狀態,您可以從伸縮活動詳情查看無效的執行個體。

  • false:從伸縮組中移出一批執行個體時不會忽略無效執行個體。

    如果一批執行個體中存在無效執行個體(例如執行個體狀態為加入中),則返回結果會報錯。

預設值:false。

false

DetachOption

string

指定是否停止使用 ECS 執行個體或 ECI 執行個體作為負載平衡執行個體的後端伺服器(即將 ECS 執行個體或 ECI 執行個體移出負載平衡執行個體的預設伺服器組和虛擬伺服器組),以及是否將 ECS 執行個體或 ECI 執行個體移出 RDS 執行個體的存取白名單。

both:將 ECS 執行個體或 ECI 執行個體移出負載平衡執行個體的預設伺服器組和虛擬伺服器組,並將 ECS 執行個體或 ECI 執行個體移出 RDS 執行個體的存取白名單。

說明

伸縮組移出託管執行個體時不支援設定該參數項。

both

InstanceId

array

待移出 ECS 執行個體、ECI 執行個體或託管執行個體的 ID。

i-bp109k5j3dum1ce6****

string

待移出 ECS 執行個體、ECI 執行個體或託管執行個體的 ID。N 的取值範圍:1~20。

舉例如下所示:

  • 待移出的 ECS 執行個體 ID 為i-bp109k5j3dum1ce6****

  • 待移出的 ECI 執行個體 ID 為eci-bp17gw49eu09yiwm****

  • 待移出的託管執行個體 ID 為mi-d23fsd******

說明

一次呼叫請求只支援移出一種類型執行個體。

i-bp109k5j3dum1ce6****

LifecycleHook

boolean

伸縮組移出 ECS 執行個體或 ECI 執行個體時,是否觸發縮容生命週期掛鉤。取值範圍:

  • true:觸發。

  • false:不觸發。

說明

伸縮組移出託管執行個體時不支援設定該參數項。

預設值:false。

false

ClientToken

string

保證請求冪等性。

從您的用戶端生成一個參數值,確保不同請求間該參數值唯一。只支援 ASCII 字元,且不能超過 64 個字元。更多資訊,請參見如何保證冪等性

123e4567-e89b-12d3-a456-42665544****

返回參數

名稱

類型

描述

樣本值

object

ScalingActivityId

string

伸縮活動的 ID。

asa-bp1gbswjhjrw8tko****

RequestId

string

請求 ID。

473469C7-AA6F-4DC5-B3DB-A3DC0DE3****

樣本

正常返回樣本

JSON格式

{
  "ScalingActivityId": "asa-bp1gbswjhjrw8tko****",
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}

錯誤碼

HTTP status code

錯誤碼

錯誤資訊

描述

500 InternalError The request processing has failed due to some unknown error, exception or failure.

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

變更歷史

更多資訊,參考變更詳情