全部產品
Search

搜尋本產品

    Cloud Monitor：PutResourceMetricRules - 為指定資源的指定監控項設定多條閾值警示規則

    文件中心

    Cloud Monitor：PutResourceMetricRules - 為指定資源的指定監控項設定多條閾值警示規則

    更新時間：Dec 24, 2025

    調用PutResourceMetricRules介面為指定資源的指定監控項設定多條閾值警示規則。

    介面說明

    本文將提供一個樣本，為Elastic Compute Service acs_ecs_dashboard的執行個體i-uf6j91r34rnwawoo****中的監控項cpu_total設定閾值警示規則。該警示規則的警示聯絡組為ECS_Group、警示規則名稱為test123、警示規則 ID 為a151cd6023eacee2f0978e03863cc1697c89508****、Critical 層級的統計方法為Average、Critical 層級的比較符為GreaterThanOrEqualToThreshold、Critical 層級的閾值為90和 Critical 層級的警示重試次數為3。

    說明

    2024-08-15 增加 Statistics 校正，統計值只能填對應指標的 Statistics。關於如何擷取該參數的取值，請參見雲產品監控項。

    調試

    您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

    調試

    授權資訊

    當前API暫無授權資訊透出。

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    Rules

    array<object>

    是

    閾值警示規則列表。

    N 的取值範圍：1~50。

    array<object>

    否

    無。

    Escalations.Info.Threshold

    string

    否

    Info 層級警示閾值。

    說明

    警示層級 Critical（嚴重）、Warn（警告）或 Info（資訊）至少設定一個，且該警示層級中的參數 Statistics、ComparisonOperator、Threshold 和 Times 必須同時設定。

    90
    MetricName

    string

    否

    監控項名稱。

    N 的取值範圍：1~50。

    關於如何查詢監控項名稱，請參見雲產品監控項。

    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，也可以使用CloudMonitor已存在的警示規則 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。

    該參數的取值由指定雲產品的MetricName對應的Statistics列決定，例如：Maximum、Minimum 和 Average。關於如何擷取該參數的取值，請參見雲產品監控項。

    說明

    警示層級 Critical（嚴重）、Warn（警告）或 Info（資訊）至少設定一個，且該警示層級中的參數 Statistics、ComparisonOperator、Threshold 和 Times 必須同時設定。

    Average
    Escalations.Warn.ComparisonOperator

    string

    否

    Warn 層級閾值比較符。取值：

    • GreaterThanOrEqualToThreshold：大於等於。

    • GreaterThanThreshold：大於。

    • LessThanOrEqualToThreshold：小於等於。

    • LessThanThreshold：小於。

    • NotEqualToThreshold：不等於。

    • EqualToThreshold：等於。

    • GreaterThanYesterday：同比昨天時間上漲。

    • LessThanYesterday：同比昨天時間下降。

    • GreaterThanLastWeek：同比上周同一時間上漲。

    • LessThanLastWeek：同比上周同一時間下降。

    • GreaterThanLastPeriod：環比上周期上漲。

    • LessThanLastPeriod：環比上周期下降。

    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

    是

    資源資訊，例如：[{"instanceId":"i-uf6j91r34rnwawoo****"}]、[{"userId":"100931896542****"}]。

    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

    是

    雲產品的資料命名空間。

    N 的取值範圍：1~50。

    關於如何查詢雲產品的資料命名空間，請參見雲產品監控項。

    acs_ecs_dashboard
    EmailSubject

    string

    否

    警示郵件主題。

    N 的取值範圍：1~50。

    ECS執行個體警示
    Period

    string

    否

    監控項的統計周期。

    單位：秒。預設為監控項的原始上報周期。

    N 的取值範圍：1~50。

    說明

    關於如何查詢監控項的統計周期，請參見雲產品監控項。

    60
    RuleName

    string

    是

    警示規則名稱。

    N 的取值範圍：1~50。

    您可以輸入新的警示規則名稱，也可以使用CloudMonitor已存在的警示規則名稱。關於如何查詢警示規則名稱，請參見 DescribeMetricRuleList 。

    說明

    輸入新的警示規則名稱，表示建立一條閾值警示規則。

    test123
    Escalations.Info.Statistics

    string

    否

    Info 層級警示統計方法。

    N 的取值範圍：1~50。

    該參數的取值由指定雲產品的MetricName對應的Statistics列決定，例如：Maximum、Minimum 和 Average。關於如何擷取該參數的取值，請參見雲產品監控項。

    說明

    警示層級 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 層級閾值比較符。取值：

    • GreaterThanOrEqualToThreshold：大於等於。

    • GreaterThanThreshold：大於。

    • LessThanOrEqualToThreshold：小於等於。

    • LessThanThreshold：小於。

    • NotEqualToThreshold：不等於。

    • EqualToThreshold：等於。

    • GreaterThanYesterday：同比昨天時間上漲。

    • LessThanYesterday：同比昨天時間下降。

    • GreaterThanLastWeek：同比上周同一時間上漲。

    • LessThanLastWeek：同比上周同一時間下降。

    • GreaterThanLastPeriod：環比上周期上漲。

    • LessThanLastPeriod：環比上周期下降。

    N 的取值範圍：1~50。

    說明

    警示層級 Critical（嚴重）、Warn（警告）或 Info（資訊）至少設定一個，且該警示層級中的參數 Statistics、ComparisonOperator、Threshold 和 Times 必須同時設定。

    GreaterThanOrEqualToThreshold
    Interval

    string

    否

    警示規則的觸發周期。

    單位：秒。

    N 的取值範圍：1~50。

    說明

    關於如何查詢監控項的統計周期，請參見雲產品監控項。

    60
    Escalations.Critical.ComparisonOperator

    string

    否

    Critical 層級閾值比較符。取值：

    • GreaterThanOrEqualToThreshold：大於等於。

    • GreaterThanThreshold：大於。

    • LessThanOrEqualToThreshold：小於等於。

    • LessThanThreshold：小於。

    • NotEqualToThreshold：不等於。

    • EqualToThreshold：等於。

    • GreaterThanYesterday：同比昨天時間上漲。

    • LessThanYesterday：同比昨天時間下降。

    • GreaterThanLastWeek：同比上周同一時間上漲。

    • LessThanLastWeek：同比上周同一時間下降。

    • GreaterThanLastPeriod：環比上周期上漲。

    • LessThanLastPeriod：環比上周期下降。

    N 的取值範圍：1~50。

    說明

    警示層級 Critical（嚴重）、Warn（警告）或 Info（資訊）至少設定一個，且該警示層級中的參數 Statistics、ComparisonOperator、Threshold 和 Times 必須同時設定。

    GreaterThanOrEqualToThreshold
    Escalations.Warn.Statistics

    string

    否

    Warn 層級警示統計方法。

    N 的取值範圍：1~50。

    該參數的取值由指定雲產品的MetricName對應的Statistics列決定，例如：Maximum、Minimum 和 Average。關於如何擷取該參數的取值，請參見雲產品監控項。

    說明

    警示層級 Critical（嚴重）、Warn（警告）或 Info（資訊）至少設定一個，且該警示層級中的參數 Statistics、ComparisonOperator、Threshold 和 Times 必須同時設定。

    Average
    NoDataPolicy

    string

    否

    無監控資料時警示的處理方式。取值：

    • KEEP_LAST_STATE（預設值）：不做任何處理。

    • INSUFFICIENT_DATA：警示內容為無資料。

    • OK：正常。

    N 的取值範圍：1~50。

    KEEP_LAST_STATE
    Labels

    array<object>

    否

    當監控項達到警示條件並進行警示時，標籤同時寫入監控項，在警示通知中進行展示。

    object

    否

    無。

    Key

    string

    否

    標籤鍵。

    tagKey1
    Value

    string

    否

    標籤值。

    說明

    標籤值支援模板參數，將模板參數替換為實際標籤值。

    ECS

    關於公用請求參數的詳情，請參見公用參數。

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    無。

    Code

    string

    狀態代碼。

    說明

    200 表示成功。

    200
    Message

    string

    錯誤資訊。

    The request processing has failed due to some unknown error.
    RequestId

    string

    請求 ID。

    15D1440E-BF24-5A41-93E4-36864635179E
    Success

    boolean

    操作是否成功。取值：

    • true：成功。

    • false：失敗。

    true
    FailedListResult

    object

    Target

    array<object>

    為資源設定警示規則的失敗結果清單。

    array<object>

    無。

    RuleId

    string

    警示規則 ID。

    a151cd6023eacee2f0978e03863cc1697c89508****
    Result

    object

    失敗結果。

    Code

    string

    狀態代碼。

    404
    Message

    string

    錯誤資訊。

    The request processing has failed due to some unknown error.
    Success

    boolean

    操作是否成功。取值：

    • true：成功。

    • false：失敗。

    false

    樣本

    正常返回樣本

    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

    錯誤碼

    錯誤資訊

    描述
    400 %s %s
    422 %s %s
    499 %s %s
    500 InternalError The request processing has failed due to some unknown error.
    204 %s %s
    403 %s %s
    206 %s %s
    404 %s %s
    503 %s %s
    406 %s %s

    訪問錯誤中心查看更多錯誤碼。

    變更歷史

    更多資訊，參考變更詳情。