すべてのプロダクト
Search

このプロダクト

    Cloud Monitor:DescribeActiveMetricRuleList

    ドキュメントセンター

    Cloud Monitor:DescribeActiveMetricRuleList

    最終更新日:Jan 23, 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:DescribeActiveMetricRuleList

    get

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    Product

    string

    必須

    アクティブなアラートルールをサポートするクラウドサービスの略称。

    クラウドサービス名の取得方法の詳細については、「DescribeProductsOfActiveMetricRule」をご参照ください。

    ecs

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    なし。

    Code

    string

    HTTP ステータスコード。

    説明

    状態コード 200 は、リクエストが成功したことを示します。

    200
    Message

    string

    返されたメッセージ。

    The Request is not authorization.
    RequestId

    string

    リクエスト ID。

    F82E6667-7811-4BA0-842F-5B2DC42BBAAD
    Success

    boolean

    リクエストが成功したかどうかを示します。有効な値：

    • true

    • false

    true
    Datapoints

    object

    Alarm

    array<object>

    アラートルールの詳細。

    object

    SilenceTime

    string

    トリガー条件が満たされても新しいアラートが送信されないミュート期間。

    単位：秒。

    86400
    MetricName

    string

    メトリック名。

    cpu_total
    EvaluationCount

    string

    アラートがトリガーされる前に、メトリック値がアラート条件を満たす連続回数。

    3
    Webhook

    string

    コールバック URL。

    https://www.aliyun.com
    State

    string

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

    Enable
    ContactGroups

    string

    アラートグループ。

    ECS_Group
    Namespace

    string

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

    acs_ecs_dashboard
    RuleName

    string

    アラートルールの名前。

    SystemDefault_acs_rds_dashboard_CpuUsage
    RuleId

    string

    アラートルールの ID。

    a151cd6023eacee2f0978e03863cc1697c89508****
    Period

    string

    モニタリングデータの集計期間。

    単位：秒。

    60
    ComparisonOperator

    string

    アラートルールで使用される比較演算子。有効な値：

    • >

    • <

    • >=

    • <=

    • =

    • =

    >
    EndTime

    string

    アラートルールが有効な期間の終了時刻。

    単位：時間。たとえば、値 23 は 23:59:59 を示します。

    24
    StartTime

    string

    アラートルールが有効な期間の開始時刻。

    単位：時間。たとえば、値 00 は 00:00:00 を示します。

    00
    Threshold

    string

    アラートのしきい値。

    90
    Statistics

    string

    統計メソッド。

    Average
    Enable

    string

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

    • true：アラートルールは有効です。

    • false：アラートルールは無効です。

    true
    AlertList

    object

    Alert

    array<object>

    アラートルールの詳細。結果は、DescribeMetricRuleList 操作によって返されるものと同じ構造です。

    array<object>

    SilenceTime

    string

    トリガー条件が満たされても新しいアラートが送信されないミュート期間。

    単位：秒。

    86400
    MetricName

    string

    メトリックの名前。

    cpu_total
    Webhook

    string

    コールバック URL。

    http://www.aliyun.com
    ContactGroups

    string

    アラートグループ。

    ECS_Group
    Namespace

    string

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

    acs_ecs_dashboard
    EffectiveInterval

    string

    アラートルールが有効な期間。

    00:00-23:59
    NoEffectiveInterval

    string

    アラートルールが無効な期間。

    00:00-06:00
    MailSubject

    string

    アラート通知メールの件名。

    ECS_Bucket
    RuleName

    string

    アラートルールの名前。

    myAlert
    RuleId

    string

    アラートルールの ID。

    ruleIdxxxx
    Period

    string

    モニタリングデータの集計期間。

    単位：秒。

    60
    AlertState

    string

    アラートルールの状態。有効な値：

    • OK：アラートルールにアクティブなアラートはありません。

    • ALARM：アラートルールにアクティブなアラートがあります。

    • INSUFFICIENT_DATA：データが見つかりません。

    OK
    Dimensions

    string

    指定されたリソースのモニタリングデータ。

    ""
    EnableState

    boolean

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

    • true：アラートルールは有効です。

    • false：アラートルールは無効です。

    true
    Resources

    string

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

    [{"resource":"_ALL"}]
    Escalations

    object

    異なるレベルのアラートをトリガーするための条件。

    Info

    object

    情報 (Info) レベルのアラートをトリガーするための条件。

    ComparisonOperator

    string

    メトリック値を情報 (Info) レベルのアラートのしきい値と比較するために使用されるオペレーター。有効な値：

    • GreaterThanOrEqualToThreshold：しきい値以上

    • GreaterThanThreshold：しきい値より大きい

    • LessThanOrEqualToThreshold：しきい値以下

    • LessThanThreshold：しきい値未満

    • NotEqualToThreshold：しきい値と等しくない

    • GreaterThanYesterday：昨日の同時刻のメトリック値より大きい

    • LessThanYesterday：昨日の同時刻のメトリック値未満

    • GreaterThanLastWeek：先週の同時刻のメトリック値より大きい

    • LessThanLastWeek：先週の同時刻のメトリック値未満

    • GreaterThanLastPeriod：最後のモニタリングサイクルのメトリック値より大きい

    • LessThanLastPeriod：最後のモニタリングサイクルのメトリック値未満

    GreaterThanThreshold
    Times

    string

    情報 (Info) レベルのアラートがトリガーされる前に、メトリック値がアラート条件を満たす連続回数。

    3
    Threshold

    string

    情報 (Info) レベルのアラートのしきい値。

    95
    Statistics

    string

    情報 (Info) レベルのアラートの統計メソッド。

    Average
    Warn

    object

    警告 (Warn) レベルのアラートをトリガーするための条件。

    ComparisonOperator

    string

    メトリック値を警告 (Warn) レベルのアラートのしきい値と比較するために使用されるオペレーター。有効な値：

    • GreaterThanOrEqualToThreshold：しきい値以上

    • GreaterThanThreshold：しきい値より大きい

    • LessThanOrEqualToThreshold：しきい値以下

    • LessThanThreshold：しきい値未満

    • NotEqualToThreshold：しきい値と等しくない

    • GreaterThanYesterday：昨日の同時刻のメトリック値より大きい

    • LessThanYesterday：昨日の同時刻のメトリック値未満

    • GreaterThanLastWeek：先週の同時刻のメトリック値より大きい

    • LessThanLastWeek：先週の同時刻のメトリック値未満

    • GreaterThanLastPeriod：最後のモニタリングサイクルのメトリック値より大きい

    • LessThanLastPeriod：最後のモニタリングサイクルのメトリック値未満

    GreaterThanThreshold
    Times

    string

    警告 (Warn) レベルのアラートがトリガーされる前に、メトリック値がアラート条件を満たす連続回数。

    3
    Threshold

    string

    警告 (Warn) レベルのアラートのしきい値。

    80
    Statistics

    string

    警告 (Warn) レベルのアラートの統計メソッド。

    Average
    Critical

    object

    重大 (Critical) レベルのアラートのトリガー条件。

    ComparisonOperator

    string

    メトリック値を重大 (Critical) レベルのアラートのしきい値と比較するために使用されるオペレーター。有効な値：

    • GreaterThanOrEqualToThreshold：しきい値以上

    • GreaterThanThreshold：しきい値より大きい

    • LessThanOrEqualToThreshold：しきい値以下

    • LessThanThreshold：しきい値未満

    • NotEqualToThreshold：しきい値と等しくない

    • GreaterThanYesterday：昨日の同時刻のメトリック値より大きい

    • LessThanYesterday：昨日の同時刻のメトリック値未満

    • GreaterThanLastWeek：先週の同時刻のメトリック値より大きい

    • LessThanLastWeek：先週の同時刻のメトリック値未満

    • GreaterThanLastPeriod：最後のモニタリングサイクルのメトリック値より大きい

    • LessThanLastPeriod：最後のモニタリングサイクルのメトリック値未満

    GreaterThanThreshold
    Times

    string

    重大 (Critical) レベルのアラートがトリガーされる前に、メトリック値がアラート条件を満たす連続回数。

    3
    Threshold

    string

    重大 (Critical) レベルのアラートのしきい値。

    99
    Statistics

    string

    重大 (Critical) レベルのアラートの統計メソッド。

    Average

    例

    成功レスポンス

    JSONJSON

    {
  "Code": "200",
  "Message": "The Request is not authorization.",
  "RequestId": "F82E6667-7811-4BA0-842F-5B2DC42BBAAD",
  "Success": true,
  "Datapoints": {
    "Alarm": [
      {
        "SilenceTime": "86400",
        "MetricName": "cpu_total",
        "EvaluationCount": "3",
        "Webhook": "https://www.aliyun.com",
        "State": "Enable",
        "ContactGroups": "ECS_Group",
        "Namespace": "acs_ecs_dashboard",
        "RuleName": "SystemDefault_acs_rds_dashboard_CpuUsage",
        "RuleId": "a151cd6023eacee2f0978e03863cc1697c89508****",
        "Period": "60",
        "ComparisonOperator": ">",
        "EndTime": "24",
        "StartTime": "00",
        "Threshold": "90",
        "Statistics": "Average",
        "Enable": "true"
      }
    ]
  },
  "AlertList": {
    "Alert": [
      {
        "SilenceTime": "86400",
        "MetricName": "cpu_total",
        "Webhook": "http://www.aliyun.com",
        "ContactGroups": "ECS_Group",
        "Namespace": "acs_ecs_dashboard",
        "EffectiveInterval": "00:00-23:59",
        "NoEffectiveInterval": "00:00-06:00",
        "MailSubject": "ECS_Bucket",
        "RuleName": "myAlert",
        "RuleId": "ruleIdxxxx",
        "Period": "60",
        "AlertState": "OK",
        "Dimensions": "\"\"",
        "EnableState": true,
        "Resources": "[{\"resource\":\"_ALL\"}]",
        "Escalations": {
          "Info": {
            "ComparisonOperator": "GreaterThanThreshold",
            "Times": "3",
            "Threshold": "95",
            "Statistics": "Average"
          },
          "Warn": {
            "ComparisonOperator": "GreaterThanThreshold",
            "Times": "3",
            "Threshold": "80",
            "Statistics": "Average"
          },
          "Critical": {
            "ComparisonOperator": "GreaterThanThreshold",
            "Times": "3",
            "Threshold": "99",
            "Statistics": "Average"
          }
        }
      }
    ]
  }
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    400 ParameterInvalid %s
    401 AccessDeniedException You donot have sufficient access to perform this action.
    402 LimitExceeded The quota for this customer had been reached.
    403 AccessForbidden The X.509 certificate or cms access key ID provided does not exist in our records.
    404 ResourceNotFound The specified resource is not found. The specified resource is not found.

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

    変更履歴

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