華為云計(jì)算 云知識(shí) 批量添加實(shí)例BatchAddScalingInstances
批量添加實(shí)例BatchAddScalingInstances

 

接口說(shuō)明

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

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

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

project_id
 
string path

項(xiàng)目ID。

scaling_group_id
 
string path

實(shí)例ID。

Body參數(shù)
名稱(chēng) 類(lèi)型 必選 描述
instances_id
 
Array of strings

云服務(wù)器 ID。

instance_delete
 
string

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

action
 
string

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

instance_append
 
string

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

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

請(qǐng)求正常

返回碼: 400

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

返回碼: 401

Unauthorized 被請(qǐng)求的頁(yè)面需要用戶(hù)名和密碼。

返回碼: 403

Forbidden 對(duì)被請(qǐng)求的頁(yè)面訪(fǎng)問(wèn)禁止。

返回碼: 404

Not Found 服務(wù)器無(wú)法找到被請(qǐng)求的頁(yè)面。

返回碼: 405

Method Not Allowed 請(qǐng)求中指定的方法不被允許。

返回碼: 406

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

返回碼: 407

Proxy Authentication 用戶(hù)必須首先使用代理服務(wù)器進(jìn)行驗(yàn)證,這樣請(qǐng)求才會(huì)被處理

返回碼: 408

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

返回碼: 409

Conflict 由于沖突,請(qǐng)求無(wú)法被完成。

返回碼: 500

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

返回碼: 501

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

返回碼: 502

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

返回碼: 503

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

返回碼: 504

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

請(qǐng)求示例
示例 1

本示例展示將實(shí)例ID為instance_id_1和instance_id_2的兩個(gè)實(shí)例批量從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
點(diǎn)擊 彈性伸縮 (AS) SDK, 下載SDK或查看SDK文檔。SDK的安裝、認(rèn)證方式等在SDK文檔中對(duì)應(yīng)語(yǔ)言類(lèi)型的【使用】目錄下。
錯(cuò)誤碼
請(qǐng)參考 錯(cuò)誤碼說(shuō)明。