華為云計算 云知識 創(chuàng)建計劃任務(wù)CreateGroupScheduledTask
創(chuàng)建計劃任務(wù)CreateGroupScheduledTask

 

接口說明

創(chuàng)建計劃任務(wù)

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

用戶Token

project_id
 
string path

租戶ID

scaling_group_id
 
string path

伸縮組ID

Body參數(shù)
名稱 類型 必選 描述
name
 
string

計劃任務(wù)名稱

scheduled_policy
 
ScheduledPolicy object  
instance_number
 
IntegerRange object  
參數(shù):
scheduled_policy
名稱 類型 必選 描述
start_time
 
string

非必選,僅當recurrence_type不為空時生效,表示計劃任務(wù)的生效開始時間,格式為yyyy-MM-dd'T'HH:mm'Z',不填寫時默認為任務(wù)創(chuàng)建成功的時間

end_time
 
string

僅當recurrence_type不為空時生效且必選,表示計劃任務(wù)的生效結(jié)束時間,格式為yyyy-MM-dd'T'HH:mm'Z'

launch_time
 
string

必選,執(zhí)行時間,采用UTC時間,recurrence_type不填寫或為空時,格式為HH:mm, recurrence_type不為空時,格式為yyyy-MM-dd'T'HH:mm'Z'

recurrence_type
 
string

非必選,不填寫時計劃任務(wù)為定時執(zhí)行, 填寫時,為周期執(zhí)行,且只能填寫DAILY,WEEKLY,MONTHLY 中的一種,分別為按天,按周,按月周期執(zhí)行

recurrence_value
 
string

僅當recurrence_type為WEEKLY,MONTHLY時必選,表示周期執(zhí)行的具體日期,多個日期用,分割。recurrence_type為WEEKLY時,可填入1-7, recurrence_type為MONTHLY時,可填入1-31

參數(shù):
instance_number
名稱 類型 必選 描述
max
 
integer

伸縮組最大實例數(shù)

min
 
integer

伸縮組最小實例數(shù)

desire
 
integer

伸縮組期望實例數(shù)

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

Normal

名稱 類型 必選 描述
task_id
 
string

計劃任務(wù)ID

返回碼: 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

本示例為伸縮組5bc3aa02-b83e-454c-aba1-4d2095c68f8b,創(chuàng)建了一個每天16:00執(zhí)行的計劃任務(wù),將伸縮組的最大實例數(shù)設(shè)置為10,最小實例數(shù)設(shè)置為5

 
"POST https://{Endpoint}/v1/{project_id}/scaling-groups/5bc3aa02-b83e-454c-aba1-4d2095c68f8b/scheduled-tasks"
 
{ "name": "as-scheduled-task-7a75", "scheduled_policy": { "start_time": "2015-12-14T03:34Z", "end_time": "2033-12-27T03:34Z", "launch_time": "16:00", "recurrence_type": "Daily" }, "instance_number": { "max": 10, "min": 5 } }
返回示例
返回碼:200

Normal

示例 1
 
{
"task_id": "0h327883-324n-4dzd-9c61-68d03ee191dd"
}
SDK
點擊  彈性伸縮  (AS) SDK, 下載SDK或查看SDK文檔。SDK的安裝、認證方式等在SDK文檔中對應(yīng)語言類型的【使用】目錄下。
錯誤碼
請參考 錯誤碼說明。