華為云計算 云知識 批量添加實例BatchAddScalingInstances
批量添加實例BatchAddScalingInstances

 

接口說明

批量移出伸縮組中的實例或批量添加伸縮組外的實例。批量對伸縮組中的實例設(shè)置或取消其實例保護屬性。批量將伸縮組中的實例轉(zhuǎn)入或移出備用狀態(tài)。說明:- 單次最多批量操作實例個數(shù)為10。批量添加后實例數(shù)不能大于伸縮組的最大實例數(shù),批量移出后實例數(shù)不能小于伸縮組的最小實例數(shù)。- 當伸縮組處于INSERVICE狀態(tài)且沒有伸縮活動時,才能添加實例。- 當伸縮組沒有伸縮活動時,才能移出實例。- 向伸縮組中添加實例時,必須保證實例所在的可用區(qū)包含于伸縮組的可用區(qū)內(nèi)。- 實例處于INSERVICE狀態(tài)時才可以進行移出、設(shè)置或取消實例保護屬性等操作。- 當伸縮組發(fā)生自動縮容活動時,設(shè)置了實例保護的實例不會被移出伸縮組。- 批量移出 彈性伸縮 組中的實例時,若該實例加入伸縮組時綁定的監(jiān)聽器和伸縮組本身的監(jiān)聽器相同,會解綁定實例和監(jiān)聽器。若該實例加入伸縮組時綁定的監(jiān)聽器和伸縮組本身的監(jiān)聽器不同,會保留實例和監(jiān)聽器的綁定關(guān)系。

URL
POST  https://as.cn-north-1.myhuaweicloud.com/autoscaling-api/v1/{project_id}/scaling_group_instance/{scaling_group_id}/action 
請求參數(shù)
名稱 類型 IN 必選 描述
X-Auth-Token
 
string header

用戶Token。通過調(diào)用 IAM 服務(wù)獲取用戶Token接口獲取(響應(yīng)消息頭中X-Subject-Token的值)。

project_id
 
string path

項目ID。

scaling_group_id
 
string path

實例ID。

Body參數(shù)
名稱 類型 必選 描述
instances_id
 
Array of strings

云服務(wù)器 ID。

instance_delete
 
string

從伸縮組中移出實例時,是否刪除云服務(wù)器。默認為no;可選值為yes或no。只有action為REMOVE時,這個字段才生效。

action
 
string

批量操作實例action標識:添加:ADD 移除: REMOVE 設(shè)置實例保護: PROTECT 取消實例保護: UNPROTECT;轉(zhuǎn)入備用狀態(tài):ENTER_STANDBY 移出備用狀態(tài):EXIT_STANDBY

instance_append
 
string

將實例移入備用狀態(tài)時,是否補充新的云服務(wù)器。取值如下:no:不補充新的實例,默認情況為no。yes:補充新的實例。只有action為ENTER_STANDBY時,這個字段才生效。

返回參數(shù)
返回碼: 204

請求正常

返回碼: 400

Bad Request 服務(wù)器未能處理請求。

返回碼: 401

Unauthorized 被請求的頁面需要用戶名和密碼。

返回碼: 403

Forbidden 對被請求的頁面訪問禁止。

返回碼: 404

Not Found 服務(wù)器無法找到被請求的頁面。

返回碼: 405

Method Not Allowed 請求中指定的方法不被允許。

返回碼: 406

Not Acceptable 服務(wù)器生成的響應(yīng)無法被客戶端所接受。

返回碼: 407

Proxy Authentication 用戶必須首先使用代理服務(wù)器進行驗證,這樣請求才會被處理

返回碼: 408

Request Timeout 請求超出了服務(wù)器的等待時間。

返回碼: 409

Conflict 由于沖突,請求無法被完成。

返回碼: 500

Internal Server Error 請求未完成。服務(wù)異常。

返回碼: 501

Not Implemented 請求未完成。服務(wù)器不支持所請求的功能。

返回碼: 502

Bad Gateway 請求未完成。服務(wù)器從上游服務(wù)器收到一個無效的響應(yīng)。

返回碼: 503

Service Unavailable 請求未完成。系統(tǒng)暫時異常。

返回碼: 504

Gateway Timeout 網(wǎng)關(guān)超時。

請求示例
示例 1

本示例展示將實例ID為instance_id_1和instance_id_2的兩個實例批量從ID為e5d27f5c-dd76-4a61-b4bc-a67c5686719a的伸縮組添加的操作。

 
"POST /autoscaling-api/v1/{project_id}/scaling_group_instance/{scaling_group_id}/action"
 
{ "action": "ADD", "instances_id": [ "instance_id_1", "instance_id_2" ] }
SDK
點擊 彈性伸縮 (AS) SDK, 下載SDK或查看SDK文檔。SDK的安裝、認證方式等在SDK文檔中對應(yīng)語言類型的【使用】目錄下。
錯誤碼
請參考 錯誤碼說明