調(diào)用API AttachInstances將實(shí)例手動(dòng)添加到伸縮組中，即您可以將伸縮組以外的ECS實(shí)例、ECI實(shí)例或托管實(shí)例添加到伸縮組中并提供服務(wù)，或者將伸縮組中處于節(jié)省停機(jī)狀態(tài)的ECS實(shí)例重新啟動(dòng)變?yōu)榉?wù)狀態(tài)（運(yùn)行中狀態(tài)）并在伸縮組中提供服務(wù)。
接口說明
- 調(diào)用該接口前，請(qǐng)確保滿足以下條件：
- 伸縮組處于 Active 狀態(tài)。
- 伸縮組內(nèi)沒有執(zhí)行中的伸縮活動(dòng)。
- 加入伸縮組的 ECS 實(shí)例或 ECI 實(shí)例的限制條件包括：
- 必須與伸縮組在同一個(gè)地域。
- 必須處于 Running 狀態(tài)。
- 不能已加入到其他伸縮組中。
- 付費(fèi)方式為包年包月、按量付費(fèi)或搶占式實(shí)例。
- 如果伸縮組指定 VswitchID，則不支持 Classic 類型的 ECS 實(shí)例或 ECI 實(shí)例加入伸縮組，也不支持其他 VPC 的 ECS 實(shí)例或 ECI 實(shí)例加入伸縮組。
- 如果伸縮組沒有指定 VswitchID，則不支持 VPC 類型的 ECS 實(shí)例或 ECI 實(shí)例加入伸縮組。
- 加入伸縮組的托管實(shí)例的限制條件包括：
- 必須與伸縮組在同一個(gè)地域。
- 只能將未加入伸縮組的托管實(shí)例加入到 ECS 類型伸縮組中。
- 托管實(shí)例不支持配置生命周期掛鉤、關(guān)聯(lián)到負(fù)載均衡和健康檢查功能。
- 托管實(shí)例加入 ECS 類型伸縮組后，該伸縮組不會(huì)管理托管實(shí)例的生命周期。
- 托管實(shí)例僅支持手動(dòng)添加到伸縮組或手動(dòng)從伸縮組移出，移出后托管實(shí)例并不會(huì)被釋放。
- 使用該接口需注意以下事項(xiàng)：
- 當(dāng)伸縮組沒有伸縮活動(dòng)正在執(zhí)行時(shí)，該接口可以繞過冷卻時(shí)間（Cooldown）直接執(zhí)行。
- 調(diào)用該接口返回成功，只是表示彈性伸縮服務(wù)接受了該接口調(diào)用的請(qǐng)求，伸縮活動(dòng)可以執(zhí)行，但不代表伸縮活動(dòng)能夠執(zhí)行成功。您需要通過返回的 ScalingActivityId 查看該伸縮活動(dòng)的執(zhí)行狀態(tài)。
- 如果該接口指定的實(shí)例數(shù)加上當(dāng)前伸縮組的實(shí)例數(shù)（Total Capacity）大于最大值（MaxSize），則接口調(diào)用失敗。
- 通過該接口手動(dòng)添加的 ECS 實(shí)例、ECI 實(shí)例或托管實(shí)例不與伸縮組生效的伸縮配置進(jìn)行關(guān)聯(lián)。
調(diào)試
您可以在OpenAPI Explorer中直接運(yùn)行該接口，免去您計(jì)算簽名的困擾。運(yùn)行成功后，OpenAPI Explorer可以自動(dòng)生成SDK代碼示例。
授權(quán)信息
下表是API對(duì)應(yīng)的授權(quán)信息，可以在RAM權(quán)限策略語(yǔ)句的Action元素中使用，用來(lái)給RAM用戶或RAM角色授予調(diào)用此API的權(quán)限。具體說明如下：
- 操作：是指具體的權(quán)限點(diǎn)。
- 訪問級(jí)別：是指每個(gè)操作的訪問級(jí)別，取值為寫入（Write）、讀取（Read）或列出（List）。
- 資源類型：是指操作中支持授權(quán)的資源類型。具體說明如下：
- 對(duì)于必選的資源類型，用背景高亮的方式表示。
- 對(duì)于不支持資源級(jí)授權(quán)的操作，用
全部資源表示。
- 條件關(guān)鍵字：是指云產(chǎn)品自身定義的條件關(guān)鍵字。
- 關(guān)聯(lián)操作：是指成功執(zhí)行操作所需要的其他權(quán)限。操作者必須同時(shí)具備關(guān)聯(lián)操作的權(quán)限，操作才能成功。
| 操作 | 訪問級(jí)別 | 資源類型 | 條件關(guān)鍵字 | 關(guān)聯(lián)操作 |
|---|---|---|---|---|
| ess:AttachInstances | update | *ScalingGroup acs:ess:{#regionId}:{#accountId}:scalinggroup/{#ScalingGroupId} |
| 無(wú) |
請(qǐng)求參數(shù)
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| ScalingGroupId | string | 是 | 伸縮組的 ID。 | asg-bp18p2yfxow2dloq**** |
| Entrusted | boolean | 否 | 將已經(jīng)存在的實(shí)例手動(dòng)添加到伸縮組時(shí)，是否將該實(shí)例的生命周期托管給伸縮組。取值范圍：
說明
包年包月實(shí)例、托管實(shí)例和伸縮組中節(jié)省停機(jī)實(shí)例不支持設(shè)置該參數(shù)項(xiàng)。
默認(rèn)值：false。 | false |
| InstanceIds | array | 否 | 待添加 ECS 實(shí)例、ECI 實(shí)例、托管實(shí)例或者伸縮組中處于節(jié)省停機(jī)狀態(tài)實(shí)例的 ID。 | |
| string | 否 | 待添加 ECS 實(shí)例、ECI 實(shí)例、托管實(shí)例或者伸縮組中處于節(jié)省停機(jī)狀態(tài)實(shí)例的 ID。 舉例如下所示：
說明
一次調(diào)用請(qǐng)求中僅支持處理一種類型的實(shí)例。
| i-28wt4**** | |
| LoadBalancerWeights | array | 否 | ECS 實(shí)例或 ECI 實(shí)例作為負(fù)載均衡實(shí)例后端服務(wù)器時(shí)的權(quán)重。 | |
| integer | 否 | 為 ECS 實(shí)例或 ECI 實(shí)例作為負(fù)載均衡實(shí)例后端服務(wù)器時(shí)的權(quán)重，該參數(shù)的取值范圍：1~100。 說明
托管實(shí)例和伸縮組中節(jié)省停機(jī)實(shí)例不支持設(shè)置該參數(shù)項(xiàng)。
默認(rèn)值：50。 | 50 | |
| LifecycleHook | boolean | 否 | 伸縮組添加實(shí)例時(shí)，是否觸發(fā)擴(kuò)容生命周期掛鉤。取值范圍：
說明
托管實(shí)例和伸縮組中節(jié)省停機(jī)實(shí)例不支持設(shè)置該參數(shù)項(xiàng)。
默認(rèn)值：false。 | false |
| RegionId | string | 否 | 伸縮組所屬的地域 ID。 | cn-qingdao |
| ClientToken | string | 否 | 保證請(qǐng)求冪等性。 從您的客戶端生成一個(gè)參數(shù)值，確保不同請(qǐng)求間該參數(shù)值唯一。只支持 ASCII 字符，且不能超過 64 個(gè)字符。更多信息，請(qǐng)參見如何保證冪等性。 | 123e4567-e89b-12d3-a456-42665544**** |
返回參數(shù)
示例
正常返回示例
JSON格式
{
"ScalingActivityId": "asa-bp1crxor24s28xf1****",
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE****"
}錯(cuò)誤碼
| HTTP status code | 錯(cuò)誤碼 | 錯(cuò)誤信息 |
|---|---|---|
| 500 | InternalError | The request processing has failed due to some unknown error, exception or failure. |
訪問錯(cuò)誤中心查看更多錯(cuò)誤碼。
變更歷史
| 變更時(shí)間 | 變更內(nèi)容概要 | 操作 |
|---|