針對具有突發(fā)性或時間上不易預測的業(yè)務,調(diào)用CreateAlarm創(chuàng)建一個報警任務,該任務關(guān)聯(lián)云監(jiān)控指標后,可以動態(tài)調(diào)整伸縮組內(nèi)的ECS實例或ECI實例數(shù)量,并實時監(jiān)控實例指標,幫助您更好地管理和維護云資源。
接口說明
- 如果您創(chuàng)建自定義監(jiān)控類型的報警任務(MetricType=custom),您需要先將自定義監(jiān)控項指標上報到云監(jiān)控。具體操作,請參見自定義監(jiān)控報警任務。
- 創(chuàng)建報警任務時,您需要指定監(jiān)控項(MetricName),并配合維度信息(Dimensions.DimensionKey 和 Dimensions.DimensionValue),來確定伸縮組中該監(jiān)控項數(shù)據(jù)的聚合范圍。例如,指定 user_id 和 scaling_group 來確定聚合該用戶、該伸縮組下所有 ECS 實例或 ECI 實例的監(jiān)控項數(shù)據(jù)。
- 自定義監(jiān)控報警任務(MetricType=custom)的監(jiān)控項取決于您自有的監(jiān)控指標。
- 系統(tǒng)監(jiān)控報警任務(MetricType=system)支持的監(jiān)控項的更多信息,請參見系統(tǒng)監(jiān)控報警任務。
Dimensions.DimensionKey
和Dimensions.DimensionValue
。
調(diào)試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
授權(quán)信息
請求參數(shù)
名稱 | 類型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
RegionId | string | 是 | 伸縮組所屬的地域 ID。 | cn-hangzhou |
Name | string | 否 | 報警任務的名稱。 | TestAlarmTask |
Description | string | 否 | 報警任務的描述。 | Test alarm task. |
ScalingGroupId | string | 是 | 報警任務關(guān)聯(lián)的伸縮組的 ID。 | asg-bp18p2yfxow2dloq**** |
MetricName | string | 否 | 監(jiān)控項名稱。取值范圍與報警任務的監(jiān)控類型有關(guān):
更多信息,請參見系統(tǒng)監(jiān)控報警任務。 | CpuUtilization |
MetricType | string | 否 | 監(jiān)控項類型。取值范圍:
| system |
Period | integer | 否 | 統(tǒng)計監(jiān)控項數(shù)據(jù)的周期,單位:秒。取值范圍:
說明
僅 ECS 類型的伸縮組支持設(shè)置 15 秒的統(tǒng)計周期。
默認值:300。 | 300 |
Statistics | string | 否 | 統(tǒng)計監(jiān)控項數(shù)據(jù)的方法。取值范圍:
默認值:Average。 | Average |
Threshold | float | 否 | 監(jiān)控指標的閾值,滿足閾值表達式達到指定次數(shù)即觸發(fā)執(zhí)行伸縮規(guī)則。 | 80.0 |
ComparisonOperator | string | 否 | 監(jiān)控項統(tǒng)計值與閾值的比較符,用于指定監(jiān)控項統(tǒng)計值與閾值在什么關(guān)系下滿足條件。取值范圍:
默認值:>=。 | >= |
EvaluationCount | integer | 否 | 觸發(fā)執(zhí)行伸縮規(guī)則需要滿足閾值表達式的次數(shù),例如,CPU 使用率平均值 3 次的統(tǒng)計結(jié)果均大于等于 80%。 默認值:3。 | 3 |
GroupId | integer | 否 | 自定義監(jiān)控項所屬云監(jiān)控應用分組的 ID,僅在監(jiān)控項類型為 custom 時需要指定該參數(shù)。 | 4055401 |
Effective | string | 否 | 指定報警任務的生效時間段,默認所有時間都生效。 該參數(shù)遵循 Cron 表達式,默認格式為
說明
該參數(shù)指定值默認為 UTC+8 時區(qū),支持在 Cron 表達式之前添加時區(qū)信息 TZ=+yy 來指定時區(qū),其中 y 表示時區(qū)的數(shù)值。例如,TZ=+00 * * 1-2 * * ? 表示報警任務在 UTC+0 時區(qū)每天 01:00~02:59 之間生效。
取值示例及含義如下:
| TZ=+00 * * 1-2 * * ? |
AlarmActions | array | 否 | 報警任務關(guān)聯(lián)伸縮規(guī)則的唯一標識符的列表。 | |
string | 否 | 報警任務關(guān)聯(lián)伸縮規(guī)則的唯一標識符的列表。 | ari:acs:ess:cn-hangzhou:1406926****:scalingrule/asr-bp163l21e07uhn**** | |
Dimensions | array<object> | 否 | 監(jiān)控項關(guān)聯(lián)的維度信息。 | |
object | 否 | 監(jiān)控項關(guān)聯(lián)的維度信息。 | ||
DimensionKey | string | 否 | 監(jiān)控項關(guān)聯(lián)的維度信息鍵,取值范圍與報警任務的監(jiān)控類型有關(guān):
| device |
DimensionValue | string | 否 | 監(jiān)控項關(guān)聯(lián)的維度信息值,取值范圍由 Dimensions.DimensionKey 決定:
| eth0 |
Expressions | array<object> | 否 | 多指標報警規(guī)則相關(guān)信息。 | |
object | 否 | 多指標報警規(guī)則相關(guān)信息。 | ||
MetricName | string | 否 | 多指標報警規(guī)則的監(jiān)控指標名稱。取值范圍與報警任務的監(jiān)控類型有關(guān):
更多信息,請參見系統(tǒng)監(jiān)控報警任務。 | CpuUtilization |
ComparisonOperator | string | 否 | 多指標報警規(guī)則的監(jiān)控項統(tǒng)計值與閾值的比較符,用于指定監(jiān)控項統(tǒng)計值與閾值在什么關(guān)系下滿足條件。取值范圍:
默認值:>=。 | >= |
Period | integer | 否 | 多指標報警規(guī)則中統(tǒng)計監(jiān)控項數(shù)據(jù)的周期,單位:秒。取值范圍:
說明
僅 ECS 類型的伸縮組支持設(shè)置 15 秒的統(tǒng)計周期。
默認值:300。 | 900 |
Statistics | string | 否 | 多指標報警規(guī)則中統(tǒng)計監(jiān)控項數(shù)據(jù)的方法。取值范圍:
默認值:Average。 | Average |
Threshold | float | 否 | 多指標報警規(guī)則中監(jiān)控指標的閾值,滿足閾值表達式達到指定次數(shù)即觸發(fā)執(zhí)行伸縮規(guī)則。 | 40.0 |
ExpressionsLogicOperator | string | 否 | 多指標報警條件之間的關(guān)系。取值范圍:
默認值: | && |
返回參數(shù)
示例
正常返回示例
JSON
格式
{
"AlarmTaskId": "asg-bp1hvbnmkl10vll5****_f95ce797-dc2e-4bad-9618-14fee7d1****",
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。
變更歷史
變更時間 | 變更內(nèi)容概要 | 操作 |
---|