全部產品
Search
文件中心

Auto Scaling:AttachInstances

更新時間:Sep 10, 2026

為伸縮組手動添加ECS執行個體。

介面說明

介面說明

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

    • 伸縮組處於 Active 狀態。

    • 伸縮組內沒有執行中的伸縮活動。

  • 加入伸縮組的 ECS 執行個體或 ECI 執行個體的限制條件包括: - 必須與伸縮組在同一個地域。 - 必須處於 Running 狀態。 - 不能已加入到其他伸縮組中。 - 付費方式為包年包月、隨用隨付或搶佔式執行個體。 - 如果伸縮組指定 VswitchID,則不支援 Classic 類型的 ECS 執行個體或 ECI 執行個體加入伸縮組,也不支援其他 VPC 的 ECS 執行個體或 ECI 執行個體加入伸縮組。 - 如果伸縮組沒有指定 VswitchID,則不支援 VPC 類型的 ECS 執行個體或 ECI 執行個體加入伸縮組。

  • 加入伸縮組的託管執行個體的限制條件包括:

    • 必須與伸縮組在同一個地域。

    • 只能將未加入伸縮組的託管執行個體加入到 ECS 類型伸縮組中。

    • 託管執行個體不支援配置生命週期掛鉤、關聯到負載平衡和健康檢查功能。

    • 託管執行個體加入 ECS 類型伸縮組後,該伸縮組不會管理託管執行個體的生命週期。

    • 託管執行個體僅支援手動添加到伸縮組或手動從伸縮組移出,移出後託管執行個體並不會被釋放。

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

    • 當伸縮組沒有伸縮活動正在執行時,該介面可以繞過冷卻時間(Cooldown)直接執行。

    • 呼叫該介面返回成功,只是表示彈性伸縮服務接受了該介面呼叫的請求,伸縮活動可以執行,但不代表伸縮活動能夠執行成功。您需要透過返回的 ScalingActivityId 查看該伸縮活動的執行狀態。

    • 如果該介面指定的執行個體數加上當前伸縮組的執行個體數(Total Capacity)大於最大值(MaxSize),則介面呼叫失敗。

    • 透過該介面手動添加的 ECS 執行個體、ECI 執行個體或託管執行個體不與伸縮組生效的伸縮配置進行關聯。

調試

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

調試

授權資訊

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

請求參數

名稱

類型

必填

描述

樣本值

ScalingGroupId

string

伸縮組的 ID。

asg-bp18p2yfxow2dloq****

Entrusted

boolean

將已經存在的執行個體手動添加到伸縮組時,是否將該執行個體的生命週期託管給伸縮組。取值範圍:

  • true:託管。該執行個體的生命週期由彈性伸縮管理,與伸縮組自動建立的執行個體一致。執行個體被移出伸縮組(不包括透過呼叫DetachInstances參數移出的執行個體)時會自動釋放。

  • false:不託管。該執行個體在被移出伸縮組時不會被釋放。

說明

包年包月執行個體、託管執行個體和伸縮組中節省停機執行個體均不支援設定該參數項。

預設值:false。

false

InstanceId

array

InstanceId.N 為待添加 ECS 執行個體、ECI 執行個體、託管執行個體或者伸縮組中處於節省停機狀態執行個體的 ID。N 的取值範圍:1~20。

舉例如下所示:

  • 待添加的 ECS 執行個體 ID 為i-28wt4****

  • 待添加的 ECI 執行個體 ID 為eci-bp17gw49eu09yiwm****

  • 待添加的託管執行個體 ID 為mi-2cx*****

  • 待重新啟動的伸縮組中節省停機狀態執行個體 ID 為i-2cd2f****

說明

一次呼叫請求中僅支援處理一種類型的執行個體。

i-28wt4****

string

InstanceId.N 為待添加 ECS 執行個體、ECI 執行個體、託管執行個體或者伸縮組中處於節省停機狀態執行個體的 ID。N 的取值範圍:1~20。

舉例如下所示:

  • 待添加的 ECS 執行個體 ID 為i-28wt4****

  • 待添加的 ECI 執行個體 ID 為eci-bp17gw49eu09yiwm****

  • 待添加的託管執行個體 ID 為mi-2cx*****

  • 待重新啟動的伸縮組中節省停機狀態執行個體 ID 為i-2cd2f****

說明

一次呼叫請求中僅支援處理一種類型的執行個體。

i-28wt4****

LoadBalancerWeight

array

ECS 執行個體或 ECI 執行個體作為負載平衡後端伺服器時的權重。

說明

託管執行個體和伸縮組中節省停機執行個體均不支援設定該參數項。

50

integer

LoadBalancerWeight.N 為 ECS 執行個體或 ECI 執行個體作為負載平衡執行個體後端伺服器時的權重,N 的取值範圍:1~20,該參數的取值範圍:1~100。

說明

託管執行個體和伸縮組中節省停機執行個體均不支援設定該參數項。

預設值:50。

50

LifecycleHook

boolean

伸縮組添加執行個體時,是否觸發擴容生命週期掛鉤。取值範圍:

  • true:觸發。

  • false:不觸發。

說明

託管執行個體和伸縮組中節省停機執行個體均不支援設定該參數項。

預設值:false。

false

RegionId

string

伸縮組所屬的地域 ID。

cn-qingdao

ClientToken

string

保證請求冪等性。

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

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

IgnoreInvalidInstance

boolean

向伸縮組添加一批執行個體時,是否忽略其中無效的執行個體。取值範圍:

  • true:從伸縮組中添加一批執行個體時,會忽略其中無效的執行個體。如果存在無效的執行個體,並且有效的執行個體被成功添加時,伸縮活動執行狀態也會顯示為警告狀態,可以從伸縮活動詳情查看無效的執行個體。

  • false:從伸縮組中添加一批執行個體時,不會忽略無效的執行個體。如果一批執行個體中存在無效的執行個體,請求會報錯。

預設值:false。

false

返回參數

名稱

類型

描述

樣本值

object

ScalingActivityId

string

伸縮活動的 ID。

asa-bp1crxor24s28xf1****

RequestId

string

請求 ID。

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

樣本

正常返回樣本

JSON格式

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

錯誤碼

HTTP status code

錯誤碼

錯誤資訊

描述

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

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

變更歷史

更多資訊,參考變更詳情