すべてのプロダクト
Search
ドキュメントセンター

Cloud Monitor:DescribeAlertingMetricRuleResources

最終更新日:Jul 09, 2026

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

今すぐお試しください

この 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

*All Resource

*

なし なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

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

任意

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

クラウドサービスのデータ名前空間を取得する方法については、クラウドサービスの監視メトリクス をご参照ください。

acs_mns_new

Dimensions

string

任意

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

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

AlertBeforeTime

string

任意

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

1698827400000

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

レスポンスフィールド

フィールド

説明

object

なし。

Code

integer

状態コード。

説明

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

200

Message

string

エラーメッセージ。

The request processing has failed due to some unknown error.

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

このパラメーターは非推奨です。

Threshold

string

アラートのしきい値。

10

Level

integer

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

  • 4:アラート通知は、メールと DingTalk チャットボットを使用して送信されます。

  • OK:アラートは生成されません。

3

ExpressionListJoin

string

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

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

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

&&

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**** インスタンスの 平均メトリック値 が 50 を超えてもアラートはトリガーされません。

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

  • メトリック値がしきい値を超えるインスタンスの数を制限します。たとえば、count($Average > 20) > 3 と指定した場合、3 つを超えるインスタンスの 平均メトリック値 が 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": "无",
              "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

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

変更履歴

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