為伸縮組手動添加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程式碼範例。
調試
授權資訊
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| ScalingGroupId |
string |
是 |
伸縮組的 ID。 |
asg-bp18p2yfxow2dloq**** |
| Entrusted |
boolean |
否 |
將已經存在的執行個體手動添加到伸縮組時,是否將該執行個體的生命週期託管給伸縮組。取值範圍:
說明
包年包月執行個體、託管執行個體和伸縮組中節省停機執行個體均不支援設定該參數項。 預設值:false。 |
false |
| InstanceId |
array |
否 |
InstanceId.N 為待添加 ECS 執行個體、ECI 執行個體、託管執行個體或者伸縮組中處於節省停機狀態執行個體的 ID。N 的取值範圍:1~20。 舉例如下所示:
說明
一次呼叫請求中僅支援處理一種類型的執行個體。 |
i-28wt4**** |
|
string |
否 |
InstanceId.N 為待添加 ECS 執行個體、ECI 執行個體、託管執行個體或者伸縮組中處於節省停機狀態執行個體的 ID。N 的取值範圍:1~20。 舉例如下所示:
說明
一次呼叫請求中僅支援處理一種類型的執行個體。 |
i-28wt4**** |
|
| LoadBalancerWeight |
array |
否 |
ECS 執行個體或 ECI 執行個體作為負載平衡後端伺服器時的權重。 說明
託管執行個體和伸縮組中節省停機執行個體均不支援設定該參數項。 |
50 |
|
integer |
否 |
LoadBalancerWeight.N 為 ECS 執行個體或 ECI 執行個體作為負載平衡執行個體後端伺服器時的權重,N 的取值範圍:1~20,該參數的取值範圍:1~100。 說明
託管執行個體和伸縮組中節省停機執行個體均不支援設定該參數項。 預設值:50。 |
50 |
|
| LifecycleHook |
boolean |
否 |
伸縮組添加執行個體時,是否觸發擴容生命週期掛鉤。取值範圍:
說明
託管執行個體和伸縮組中節省停機執行個體均不支援設定該參數項。 預設值:false。 |
false |
| RegionId |
string |
否 |
伸縮組所屬的地域 ID。 |
cn-qingdao |
| ClientToken |
string |
否 |
保證請求冪等性。 從您的用戶端產生一個參數值,確保不同請求間該參數值唯一。只支援 ASCII 字元,且不能超過 64 個字元。更多資訊,請參見如何保證冪等性。 |
123e4567-e89b-12d3-a456-42665544**** |
| IgnoreInvalidInstance |
boolean |
否 |
向伸縮組添加一批執行個體時,是否忽略其中無效的執行個體。取值範圍:
預設值: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. |
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊,參考變更詳情。