功能介紹
可針對不同類型資源如伸縮組或帶寬，創(chuàng)建 彈性伸縮 策略。
創(chuàng)建彈性伸縮策略V2版本與V1版本的區(qū)別在于，V2版本支持創(chuàng)建對帶寬資源進行調(diào)整的策略，通過伸縮資源類型區(qū)分伸縮資源。
調(diào)試
您可以在API Explorer中調(diào)試該接口。
URI
POST /autoscaling-api/v2/{project_id}/scaling_policy
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
項目ID |
請求參數(shù)
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
scaling_policy_name |
是 |
String |
伸縮策略名稱（1-64個字符），只能包含中文、字母、數(shù)字、下劃線或中劃線。 |
|
scaling_resource_id |
是 |
String |
伸縮資源ID，伸縮組唯一標識或帶寬唯一標識
|
|
scaling_resource_type |
是 |
string |
伸縮資源類型
|
|
scaling_policy_type |
是 |
String |
策略類型
|
|
alarm_id |
否 |
String |
告警ID，即告警規(guī)則的ID，當scaling_policy_type為ALARM時該項必選，此時scheduled_policy不生效。 創(chuàng)建告警策略成功后，會自動為該告警ID對應的告警規(guī)則的alarm_actions字段增加類型為autoscaling的告警觸發(fā)動作。 告警ID通過查詢 云監(jiān)控 告警規(guī)則列表獲取，請參考《云監(jiān)控API參考》的“查詢告警規(guī)則列表”。 |
|
scheduled_policy |
否 |
定時、周期任務策略，當scaling_policy_type為SCHEDULED或RECURRENCE時該項必選，此時alarm_id不生效。詳情請見表 scheduled_policy字段數(shù)據(jù)結(jié)構(gòu)說明。 |
|
|
scaling_policy_action |
否 |
策略執(zhí)行具體動作。詳情請見表 scaling_policy_action字段數(shù)據(jù)結(jié)構(gòu)說明。 |
|
|
cool_down_time |
否 |
Integer |
冷卻時間，取值范圍0-86400，默認為300，單位是秒。 |
|
description |
否 |
String |
伸縮策略描述（1-256個字符）。 |
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
launch_time |
是 |
String |
觸發(fā)時間，遵循UTC時間。
|
|
recurrence_type |
否 |
String |
周期觸發(fā)類型，scaling_policy_type為RECURRENCE時該項必選。
|
|
recurrence_value |
否 |
String |
周期觸發(fā)任務數(shù)值，scaling_policy_type為RECURRENCE時該項必選。
|
|
start_time |
否 |
String |
周期策略重復執(zhí)行開始時間，遵循UTC時間，默認為當前時間。 格式為：YYYY-MM-DDThh:mmZ。 |
|
end_time |
否 |
String |
周期策略重復執(zhí)行結(jié)束時間，遵循UTC時間，scaling_policy_type為RECURRENCE時該項必選。當為周期類型策略時，不得早于當前時間和開始時間。 格式為：YYYY-MM-DDThh:mmZ。 |
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
operation |
否 |
String |
操作選項，默認為ADD。
|
|
size |
否 |
Integer |
操作大小，取值范圍為0到300的整數(shù)，默認為1。只有操作為SET時取值可以為0，其余操作取值均不能為0。
|
|
percentage |
否 |
Integer |
操作百分比，操作為ADD或REMOVE/REDUCE時取值范圍為1到20000的整數(shù)，操作為SET時取值范圍為0到20000的整數(shù)。
|
|
limits |
否 |
Integer |
操作限制 當scaling_resource_type為BANDWIDTH，且operation不為SET時，limits參數(shù)生效，單位為Mbit/s。
|
請求示例
POST https://{Endpoint}/autoscaling-api/v2/{project_id}/scaling_policy
{
"alarm_id": "al1513822380493GvlJKZwA8",
"cool_down_time": 900,
"scaling_resource_id": "8ade64b5-d685-40b8-8582-4ce306ea37a6",
"scaling_resource_type": "BANDWIDTH",
"scaling_policy_action": {
"size": 1,
"operation": "ADD",
"limits": 10
},
"scaling_policy_name": "hth_aspolicy_1",
"scaling_policy_type": "ALARM"
}
響應參數(shù)
|
參數(shù) |
參數(shù)類型 |
描述 |
|---|---|---|
|
scaling_policy_id |
String |
伸縮策略ID |
響應示例
{
"scaling_policy_id": "0h327883-324n-4dzd-9c61-68d03ee191dd"
}
返回值
- 正常
- 異常
返回值
說明
400 Bad Request
服務器未能處理請求。
401 Unauthorized
被請求的頁面需要用戶名和密碼。
403 Forbidden
對被請求的頁面訪問禁止。
404 Not Found
服務器無法找到被請求的頁面。
405 Method Not Allowed
請求中指定的方法不被允許。
406 Not Acceptable
服務器生成的響應無法被客戶端所接受。
407 Proxy Authentication Required
用戶必須首先使用代理服務器進行驗證，這樣請求才會被處理。
408 Request Timeout
請求超出了服務器的等待時間。
409 Conflict
由于沖突，請求無法被完成。
500 Internal Server Error
請求未完成。服務異常。
501 Not Implemented
請求未完成。服務器不支持所請求的功能。
502 Bad Gateway
請求未完成。服務器從上游服務器收到一個無效的響應。
503 Service Unavailable
請求未完成。系統(tǒng)暫時異常。
504 Gateway Timeout
網(wǎng)關超時。
錯誤碼
請參考錯誤碼。
