調用PutResourceMetricRules接口為指定資源的指定監控項設置多條閾值報警規則。
接口說明
本文將提供一個示例,為云服務器 ECS acs_ecs_dashboard
的實例i-uf6j91r34rnwawoo****
中的監控項cpu_total
設置閾值報警規則。該報警規則的報警聯系組為ECS_Group
、報警規則名稱為test123
、報警規則 ID 為a151cd6023eacee2f0978e03863cc1697c89508****
、Critical 級別的統計方法為Average
、Critical 級別的比較符為GreaterThanOrEqualToThreshold
、Critical 級別的閾值為90
和 Critical 級別的報警重試次數為3
。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息,可以在RAM權限策略語句的Action
元素中使用,用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下:
- 操作:是指具體的權限點。
- 訪問級別:是指每個操作的訪問級別,取值為寫入(Write)、讀取(Read)或列出(List)。
- 資源類型:是指操作中支持授權的資源類型。具體說明如下:
- 對于必選的資源類型,用背景高亮的方式表示。
- 對于不支持資源級授權的操作,用
全部資源
表示。
- 條件關鍵字:是指云產品自身定義的條件關鍵字。
- 關聯操作:是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限,操作才能成功。
操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯操作 |
---|---|---|---|---|
cms:PutResourceMetricRules | create |
|
| 無 |
請求參數
名稱 | 類型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
Rules | array<object> | 是 | 閾值報警規則列表。 N 的取值范圍:1~50。 | |
object | 是 | 無。 | ||
Escalations.Info.Threshold | string | 否 | Info 級別報警閾值。 說明
報警級別 Critical(嚴重)、Warn(警告)或 Info(信息)至少設置一個,且該報警級別中的參數 Statistics、ComparisonOperator、Threshold 和 Times 必須同時設置。
| 90 |
MetricName | string | 否 | cpu_total | |
Escalations.Warn.Threshold | string | 否 | Warn 級別報警閾值。 N 的取值范圍:1~50。 說明
報警級別 Critical(嚴重)、Warn(警告)或 Info(信息)至少設置一個,且該報警級別中的參數 Statistics、ComparisonOperator、Threshold 和 Times 必須同時設置。
| 90 |
EffectiveInterval | string | 否 | 報警規則的生效時間范圍。 N 的取值范圍:1~50。 | 00:00-23:59 |
NoEffectiveInterval | string | 否 | 報警規則的失效時間范圍。 N 的取值范圍:1~50。 | 00:00-06:00 |
RuleId | string | 是 | 報警規則 ID。 N 的取值范圍:1~50。 您可以輸入新的報警規則 ID,也可以使用云監控已存在的報警規則 ID。關于如何查詢報警規則 ID,請參見 DescribeMetricRuleList 。 說明
輸入新的報警規則 ID,表示創建一條閾值報警規則。
| a151cd6023eacee2f0978e03863cc1697c89508**** |
Escalations.Critical.Times | integer | 否 | Critical 級別報警重試次數。 N 的取值范圍:1~50。 說明
報警級別 Critical(嚴重)、Warn(警告)或 Info(信息)至少設置一個,且該報警級別中的參數 Statistics、ComparisonOperator、Threshold 和 Times 必須同時設置。
| 3 |
Escalations.Critical.Threshold | string | 否 | Critical 級別報警閾值。 N 的取值范圍:1~50。 說明
報警級別 Critical(嚴重)、Warn(警告)或 Info(信息)至少設置一個,且該報警級別中的參數 Statistics、ComparisonOperator、Threshold 和 Times 必須同時設置。
| 90 |
Escalations.Critical.Statistics | string | 否 | Critical 級別報警統計方法。 N 的取值范圍:1~50。 該參數的取值由指定云產品的 說明
報警級別 Critical(嚴重)、Warn(警告)或 Info(信息)至少設置一個,且該報警級別中的參數 Statistics、ComparisonOperator、Threshold 和 Times 必須同時設置。
| Average |
Escalations.Warn.ComparisonOperator | string | 否 | Warn 級別閾值比較符。取值:
N 的取值范圍:1~50。 說明
報警級別 Critical(嚴重)、Warn(警告)或 Info(信息)至少設置一個,且該報警級別中的參數 Statistics、ComparisonOperator、Threshold 和 Times 必須同時設置。
| GreaterThanOrEqualToThreshold |
Escalations.Info.Times | integer | 否 | Info 級別報警重試次數。 N 的取值范圍:1~50。 說明
報警級別 Critical(嚴重)、Warn(警告)或 Info(信息)至少設置一個,且該報警級別中的參數 Statistics、ComparisonOperator、Threshold 和 Times 必須同時設置。
| 3 |
Resources | string | 是 | 資源信息,例如: N 的取值范圍:1~50。 關于資源信息支持的維度 Dimensions,請參見云產品監控項。 | [{"instanceId":"i-uf6j91r34rnwawoo****"}] |
SilenceTime | integer | 否 | 通道沉默周期。 單位:秒,默認值:86400。 N 的取值范圍:1~50。 說明
通道沉默周期是指報警發生后未恢復正常,間隔多久重新發送一次報警通知。
| 86400 |
Webhook | string | 否 | 報警發生回調時指定的 URL 地址,向 URL 發送 POST 請求。 N 的取值范圍:1~50。 | https://alert.aliyun.com.com:8080/callback |
ContactGroups | string | 是 | 報警聯系組。報警通知會發送給該報警聯系組中的報警聯系人。 N 的取值范圍:1~50。 說明
報警聯系組是一組報警聯系人,可以包含一個或多個報警聯系人。關于如何創建報警聯系人和報警聯系組,請參見 PutContact 和 PutContactGroup 。
| ECS_Group |
Namespace | string | 是 | acs_ecs_dashboard | |
EmailSubject | string | 否 | 報警郵件主題。 N 的取值范圍:1~50。 | ECS實例報警 |
Period | string | 否 | 60 | |
RuleName | string | 是 | 報警規則名稱。 N 的取值范圍:1~50。 您可以輸入新的報警規則名稱,也可以使用云監控已存在的報警規則名稱。關于如何查詢報警規則名稱,請參見 DescribeMetricRuleList 。 說明
輸入新的報警規則名稱,表示創建一條閾值報警規則。
| test123 |
Escalations.Info.Statistics | string | 否 | Info 級別報警統計方法。 N 的取值范圍:1~50。 該參數的取值由指定云產品的 說明
報警級別 Critical(嚴重)、Warn(警告)或 Info(信息)至少設置一個,且該報警級別中的參數 Statistics、ComparisonOperator、Threshold 和 Times 必須同時設置。
| Average |
Escalations.Warn.Times | integer | 否 | Warn 級別報警重試次數。 N 的取值范圍:1~50。 說明
報警級別 Critical(嚴重)、Warn(警告)或 Info(信息)至少設置一個,且該報警級別中的參數 Statistics、ComparisonOperator、Threshold 和 Times 必須同時設置。
| 3 |
Escalations.Info.ComparisonOperator | string | 否 | Info 級別閾值比較符。取值:
N 的取值范圍:1~50。 說明
報警級別 Critical(嚴重)、Warn(警告)或 Info(信息)至少設置一個,且該報警級別中的參數 Statistics、ComparisonOperator、Threshold 和 Times 必須同時設置。
| GreaterThanOrEqualToThreshold |
Interval | string | 否 | 60 | |
Escalations.Critical.ComparisonOperator | string | 否 | Critical 級別閾值比較符。取值:
N 的取值范圍:1~50。 說明
報警級別 Critical(嚴重)、Warn(警告)或 Info(信息)至少設置一個,且該報警級別中的參數 Statistics、ComparisonOperator、Threshold 和 Times 必須同時設置。
| GreaterThanOrEqualToThreshold |
Escalations.Warn.Statistics | string | 否 | Warn 級別報警統計方法。 N 的取值范圍:1~50。 該參數的取值由指定云產品的 說明
報警級別 Critical(嚴重)、Warn(警告)或 Info(信息)至少設置一個,且該報警級別中的參數 Statistics、ComparisonOperator、Threshold 和 Times 必須同時設置。
| Average |
NoDataPolicy | string | 否 | 無監控數據時報警的處理方式。取值:
N 的取值范圍:1~50。 | KEEP_LAST_STATE |
Labels | array<object> | 否 | 當監控項達到報警條件并進行報警時,標簽同時寫入監控項,在報警通知中進行展示。 | |
object | 否 | 無。 | ||
Key | string | 否 | 標簽鍵。 | tagKey1 |
Value | string | 否 | 標簽值。 說明
標簽值支持模板參數,將模板參數替換為實際標簽值。
| ECS |
關于公共請求參數的詳情,請參見公共參數。
返回參數
示例
正常返回示例
JSON
格式
{
"Code": "200",
"Message": "The request processing has failed due to some unknown error.",
"RequestId": "15D1440E-BF24-5A41-93E4-36864635179E",
"Success": true,
"FailedListResult": {
"Target": [
{
"RuleId": "a151cd6023eacee2f0978e03863cc1697c89508****",
"Result": {
"Code": "404",
"Message": "The request processing has failed due to some unknown error.",
"Success": false
}
}
]
}
}
錯誤碼
HTTP status code | 錯誤碼 | 錯誤信息 |
---|---|---|
204 | %s | %s |
500 | InternalError | The request processing has failed due to some unknown error. |
訪問錯誤中心查看更多錯誤碼。
變更歷史
變更時間 | 變更內容概要 | 操作 |
---|---|---|
2021-10-28 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |