すべてのプロダクト
Search

このプロダクト

    Cloud Monitor:DescribeAlertingMetricRuleResources

    ドキュメントセンター

    Cloud Monitor:DescribeAlertingMetricRuleResources

    最終更新日:Jul 21, 2026

    指定されたアラートルールに対してアラートをトリガーしているリソースのリストを照会します。

    操作説明

    この Topic では、acs_ecs_dashboard 名前空間内の ECS インスタンス i-uf6j91r34rnwawoo**** のメトリック cpu_total にしきい値ベースのアラートルールを設定する方法の例を示します。アラート連絡先グループは ECS_Group、アラートルール名は test123、アラートルール ID は a151cd6023eacee2f0978e03863cc1697c89508****、重大レベルの統計メソッドは Average、重大レベルの比較演算子は GreaterThanOrEqualToThreshold、重大レベルのしきい値は 90、重大レベルのリトライ回数は 3 です。

    説明

    2024 年 8 月 15 日、Statistics の検証が追加されました。統計値はメトリックの Statistics に対応している必要があります。このパラメーターの値を取得するメソッドの詳細については、「Alibaba Cloud サービス監視の監視メトリクス」をご参照ください。

    今すぐお試しください

    この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

    テスト

    RAM 認証

    下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

    • アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

    • API：アクションを具体的に実行するための API。

    • アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。

    • リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

      • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

      • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

    • 条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

    • 依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    cms:DescribeAlertingMetricRuleResources

    get

    *すべてのリソース。

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    RuleId

    string

    任意

    アラートルールの ID。アラートルール ID をクエリするメソッドの詳細については、「 DescribeMetricRuleList 」をご参照ください。

    putNewAlarm_user_7e78d765-0e3e-4671-ba6d-7ce39108****
    GroupId

    string

    任意

    アプリケーショングループの ID。アプリケーショングループ ID をクエリするメソッドの詳細については、「 DescribeMonitorGroups 」をご参照ください。

    7671****
    Page

    integer

    任意

    ページ番号。

    デフォルト値: 1。

    1
    PageSize

    integer

    任意

    1 ページあたりのエントリ数。

    デフォルト値: 10。

    10
    Namespace

    string

    任意

    Alibaba Cloud サービスのデータ名前空間。

    Alibaba Cloud サービスのデータ名前空間を取得するメソッドの詳細については、「Alibaba Cloud サービス監視の監視メトリクス」をご参照ください。

    acs_mns_new。
    Dimensions

    string

    任意

    指定されたリソースのモニタリングデータをクエリするために使用されるディメンションマップ。

    {\"userId\":\"120886317861****\",\"region\":\"cn-huhehaote\",\"queue\":\"test-0128\"}
    AlertBeforeTime

    string

    任意

    この時点より前に発生したアラートをクエリします。値はミリ秒単位のタイムスタンプです。

    1698827400000

    共通リクエストパラメーターの詳細については、「共通パラメーター」をご参照ください。

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    なし。

    Code

    integer

    状態コード。

    説明

    値が 200 の場合、成功を示します。

    200
    Message

    string

    エラーメッセージ。

    不明なエラーのため、リクエストの処理に失敗しました。
    RequestId

    string

    リクエスト ID。

    0724011B-D9E0-4B2F-8C51-F17A894CC42C
    Total

    integer

    レコードの総数。

    2
    Success

    boolean

    操作が成功したかどうかを示します。有効な値:

    • true: 操作が成功しました。

    • false: 操作が失敗したことを示します。

    true。
    Resources

    object

    Resource

    array<object>

    アラートルールに関連付けられているリソースのリスト。

    array<object>

    なし。

    MetricName

    string

    メトリック名。

    ActiveMessages
    RetryTimes

    string

    アラートの再試行回数。

    3
    MetricValues

    string

    アラートがトリガーされたときのメトリック値。値は JSON 文字列です。

    {\"timestamp\":1623727500000,\"Sum\":926,\"value\":463,\"Maximum\":463,\"Minimum\":463,\"Average\":463,\"SampleCount\":2,\"userId\":\"120886317861****\",\"region\":\"cn-huhehaote\",\"queue\":\"test-0128\"}
    Namespace

    string

    クラウドサービスの名前空間。

    acs_mns_new
    RuleName

    string

    アラートルール名。

    test123456789
    RuleId

    string

    アラートルールの ID。

    putNewAlarm_user_7e78d765-0e3e-4671-ba6d-7ce39108****
    ProductCategory

    string

    クラウドサービスタイプ。

    mns
    StartTime

    string

    リソースがアラートルールに関連付けられたタイムスタンプ。

    単位: ミリ秒。

    1622427900000
    Resource

    string

    アラートをトリガーしたリソース。

    userId=120886317861****,region=cn-huhehaote,queue=test-0128
    LastModifyTime

    string

    アラートルールが最後に変更済みのタイムスタンプ。

    単位: ミリ秒。

    1622827900000
    GroupId

    string

    アプリケーショングループの ID。

    説明

    アラートルールが特定のアプリケーショングループに関連付けられている場合、このアプリケーショングループ ID が表示されます。

    7671****
    Dimensions

    string

    指定されたリソースのモニタリングデータをクエリするために使用されるディメンションマップ。

    {\"region\":\"cn-huhehaote\",\"queue\":\"test-0128\",\"userId\":\"120886317861****\"}
    LastAlertTime

    string

    アラートが最後にトリガーされたタイムスタンプ。

    単位: ミリ秒。

    1622427900000
    Level

    integer

    アラートレベルと通知方法。有効な値:

    • 4: メール + DingTalk チャットボット。

    • OK: アラートなし。

    3
    Threshold

    string

    アラートのしきい値。

    10
    Statistics

    string

    アラートの統計メソッド。

    Average
    Enable

    string

    アラートルールが有効かどうかを示します。有効な値:

    • true: アラートルールが有効です。

    • false: アラートルールが無効です。

    true
    Escalation

    object

    Resource

    array<object>

    アラートをトリガーしたルール。

    array<object>

    なし。

    ComparisonOperator

    string

    しきい値の比較演算子。有効な値:

    • GreaterThanOrEqualToThreshold: 以上

    • GreaterThanThreshold: より大きい

    • LessThanOrEqualToThreshold: 以下

    • LessThanThreshold: 未満

    • NotEqualToThreshold: 等しくない

    • GreaterThanYesterday: 昨日の同時刻と比較して増加

    • LessThanYesterday: 昨日の同時刻と比較して減少

    • GreaterThanLastWeek: 先週の同時刻と比較して増加

    • LessThanLastWeek: 先週の同時刻と比較して減少

    • GreaterThanLastPeriod: 前の期間と比較して増加

    • LessThanLastPeriod: 前の期間と比較して減少

    GreaterThanOrEqualToThreshold
    PreCondition

    string

    しきい値の比較記号。有効な値:

    • >=

    • =

    • <=

    • >

    • <

    • !=

    >=
    Expression

    string

    アラートをトリガーしたルールの説明。

    説明

    これはアラートルールの本文です。モニタリングデータがアラート条件を満たすと、アラートルールがトリガーされます。

    $Average>=10
    Times

    integer

    アラートの再試行回数。

    1
    Tag

    string

    このパラメーターは非推奨であり、無視できます。

    Deprecated: true
    Threshold

    string

    アラートのしきい値。

    10
    Level

    integer

    アラートレベルと通知方法。有効な値:

    • 4: メール + DingTalk チャットボット。

    • OK: アラートなし。

    3
    ExpressionListJoin

    string

    複数のメトリック間の関係。有効な値:

    • &&: すべてのメトリックがアラート条件を満たした場合にのみ、アラート通知が送信されます。

    • ||: いずれかのメトリックがアラート条件を満たした場合に、アラート通知が送信されます。

    &&
    ExpressionList

    object

    ExpressionList

    array<object>

    複数メトリックアラートルールの説明。

    object

    なし。

    ComparisonOperator

    string

    アラートレベルのしきい値比較演算子。有効な値:

    • GreaterThanOrEqualToThreshold: 以上

    • GreaterThanThreshold: より大きい

    • LessThanOrEqualToThreshold: 以下

    • LessThanThreshold: 未満

    • NotEqualToThreshold: 等しくない

    • GreaterThanYesterday: 昨日の同時刻と比較して増加

    • LessThanYesterday: 昨日の同時刻と比較して減少

    • GreaterThanLastWeek: 先週の同時刻と比較して増加

    • LessThanLastWeek: 先週の同時刻と比較して減少

    • GreaterThanLastPeriod: 前の期間と比較して増加

    • LessThanLastPeriod: 前の期間と比較して減少

    GreaterThanOrEqualToThreshold
    MetricName

    string

    メトリック名。

    cpu_total
    Period

    string

    メトリックの統計期間。単位: 秒。デフォルト値はメトリックの元の報告期間です。

    60
    Statistics

    string

    アラートレベルの統計メソッド。有効な値:

    • Maximum: 最大値

    • Minimum: 最小値

    • Average: 平均値

    Average
    Threshold

    string

    アラートのしきい値。

    90
    ExpressionRaw

    string

    式を使用して作成されたアラート条件。以下のシナリオがサポートされていますが、これらに限定されません。

    • 特定のリソースに対してアラートブラックリストを設定します。たとえば、$instanceId != 'i-io8kfvcpp7x5****' ``&&`` $Average > 50 は、インスタンス i-io8kfvcpp7x5**** の Average が 50 を超えていてもアラートがトリガーされないことを指定します。

    • ルール内の特定のインスタンスに対して特別なアラートのしきい値を設定します。たとえば、$Average > ($instanceId == 'i-io8kfvcpp7x5****'? 80: 50) は、インスタンス i-io8kfvcpp7x5**** の Average が 80 を超えた場合にのみアラートがトリガーされ、他のインスタンスでは Average が 50 を超えた場合にアラートがトリガーされることを指定します。

    • しきい値を超えるインスタンスの数を制限します。たとえば、count($Average > 20) > 3 は、アラートルール内の 3 つ以上のインスタンスの Average が 20 を超えた場合にのみアラートがトリガーされることを指定します。

    $Average > ($instanceId == 'i-io8kfvcpp7x5****'? 80: 50)

    例

    成功レスポンス

    JSONJSON

    {
  "Code": 200,
  "Message": "The request processing has failed due to some unknown error.",
  "RequestId": "0724011B-D9E0-4B2F-8C51-F17A894CC42C",
  "Total": 2,
  "Success": true,
  "Resources": {
    "Resource": [
      {
        "MetricName": "ActiveMessages",
        "RetryTimes": "3",
        "MetricValues": "{\\\"timestamp\\\":1623727500000,\\\"Sum\\\":926,\\\"value\\\":463,\\\"Maximum\\\":463,\\\"Minimum\\\":463,\\\"Average\\\":463,\\\"SampleCount\\\":2,\\\"userId\\\":\\\"120886317861****\\\",\\\"region\\\":\\\"cn-huhehaote\\\",\\\"queue\\\":\\\"test-0128\\\"}",
        "Namespace": "acs_mns_new",
        "RuleName": "test123456789",
        "RuleId": "putNewAlarm_user_7e78d765-0e3e-4671-ba6d-7ce39108****",
        "ProductCategory": "mns",
        "StartTime": "1622427900000",
        "Resource": "userId=120886317861****,region=cn-huhehaote,queue=test-0128",
        "LastModifyTime": "1622827900000",
        "GroupId": "7671****",
        "Dimensions": "{\\\"region\\\":\\\"cn-huhehaote\\\",\\\"queue\\\":\\\"test-0128\\\",\\\"userId\\\":\\\"120886317861****\\\"}",
        "LastAlertTime": "1622427900000",
        "Level": 3,
        "Threshold": "10",
        "Statistics": "Average",
        "Enable": "true",
        "Escalation": {
          "Resource": [
            {
              "ComparisonOperator": "GreaterThanOrEqualToThreshold",
              "PreCondition": ">=",
              "Expression": "$Average>=10",
              "Times": 1,
              "Tag": "Deprecated: true",
              "Threshold": "10",
              "Level": 3,
              "ExpressionListJoin": "&&",
              "ExpressionList": {
                "ExpressionList": [
                  {
                    "ComparisonOperator": "GreaterThanOrEqualToThreshold",
                    "MetricName": "cpu_total",
                    "Period": "60",
                    "Statistics": "Average",
                    "Threshold": "90"
                  }
                ]
              },
              "ExpressionRaw": "$Average > ($instanceId == 'i-io8kfvcpp7x5****'? 80: 50)"
            }
          ]
        }
      }
    ]
  }
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    400 %s %s
    500 %s %s
    500 InternalError The request processing has failed due to some unknown error.
    403 %s %s
    404 %s %s
    503 %s %s

    完全なリストについては、「エラーコード」をご参照ください。

    変更履歴

    完全なリストについては、「変更履歴」をご参照ください。