すべてのプロダクト
Search

このプロダクト

    Cloud Monitor:PutResourceMetricRule

    ドキュメントセンター

    Cloud Monitor:PutResourceMetricRule

    最終更新日:Dec 24, 2025

    アラートルールを設定します。

    操作説明

    このトピックでは、ID が i-uf6j91r34rnwawoo**** の Elastic Compute Service (ECS) インスタンスの cpu_total メトリックに対して、しきい値ベースのアラートルールを作成する例を説明します。ECS メトリックの名前空間は acs_ecs_dashboard です。アラートルールのアラートグループは ECS_Group です。アラートルールの名前は test123 です。アラートルールの ID は a151cd6023eacee2f0978e03863cc1697c89508**** です。クリティカルレベルのアラートの統計メソッドは Average、比較オペレーターは GreaterThanOrEqualToThreshold、しきい値は 90、メトリック値がトリガー条件を満たしてからクリティカルレベルのアラートがトリガーされるまでの連続回数は 3 です。

    説明

    2024年8月15日に統計検証が追加されました。Statistics パラメーターには、対応するメトリックの統計値のみ設定できます。このパラメーターの値を取得する方法の詳細については、付録1：メトリックをご参照ください。

    今すぐお試しください

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

    テスト

    RAM 認証

    この操作の認証情報はありません。問題が発生した場合は、アカウントマネージャーにご連絡ください。

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    RuleId

    string

    必須

    アラートルールの ID です。

    新しい ID または既存のアラートルールの ID を指定できます。アラートルールの ID をクエリする方法の詳細については、DescribeMetricRuleList をご参照ください。

    説明

    新しい ID を指定すると、しきい値ベースのアラートルールが作成されます。

    a151cd6023eacee2f0978e03863cc1697c89508****
    RuleName

    string

    必須

    アラートルールの名前です。

    新しい名前または既存のアラートルールの名前を指定できます。アラートルールの名前をクエリする方法の詳細については、DescribeMetricRuleList をご参照ください。

    説明

    新しい名前を指定すると、しきい値ベースのアラートルールが作成されます。

    test123
    Namespace

    string

    必須

    クラウドサービスの名前空間です。クラウドサービスの名前空間をクエリする方法の詳細については、付録1：メトリックをご参照ください。

    説明

    ハイブリッドクラウド監視の Prometheus アラートルールを作成する場合、このパラメーターを acs_prometheus に設定する必要があります。

    acs_ecs_dashboard
    MetricName

    string

    必須

    メトリック名です。メトリック名をクエリする方法の詳細については、付録1：メトリックをご参照ください。

    説明

    ハイブリッドクラウド監視の Prometheus アラートルールを作成する場合、このパラメーターを名前空間の名前に設定する必要があります。名前空間の名前をクエリする方法の詳細については、DescribeHybridMonitorNamespaceList をご参照ください。

    cpu_total
    Resources

    string

    任意

    リソース情報です。例：[{"instanceId":"i-uf6j91r34rnwawoo****"}] および [{"userId":"100931896542****"}]。

    リソースのクエリに使用されるサポート対象のディメンションの詳細については、付録1：メトリックをご参照ください。

    [{"instanceId":"i-uf6j91r34rnwawoo****"}]
    ContactGroups

    string

    必須

    アラートグループです。アラート通知は、アラートグループ内のアラート連絡先に送信されます。

    説明

    アラートグループには、1 つ以上のアラート連絡先を含めることができます。アラート連絡先とアラートグループの作成方法については、PutContact および PutContactGroup をご参照ください。

    ECS_Group
    Webhook

    string

    任意

    アラートルールに基づいてアラートがトリガーされたときに POST リクエストが送信されるコールバック URL です。

    https://alert.aliyun.com.com:8080/callback
    EffectiveInterval

    string

    任意

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

    00:00-23:59
    NoEffectiveInterval

    string

    任意

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

    00:00-06:00
    SilenceTime

    integer

    任意

    サイレント期間です。この期間中は、トリガー条件が満たされても新しいアラート通知は送信されません。単位：秒。デフォルト値：86400。

    説明

    サイレント期間が終了してもアラートがクリアされない場合、CloudMonitor はアラート通知を再送信します。

    86400
    Period

    string

    任意

    メトリックの集計期間です。単位：秒。デフォルト値は、メトリックのモニタリングデータが収集される間隔です。

    説明

    メトリックの集計期間をクエリする方法の詳細については、付録1：メトリックをご参照ください。

    60
    Interval

    string

    任意

    アラートルールに基づいてアラートがトリガーされる間隔です。単位：秒。

    説明

    メトリックの集計期間をクエリする方法の詳細については、付録1：メトリックをご参照ください。

    60
    EmailSubject

    string

    任意

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

    ECS实例报警
    Escalations.Critical.Statistics

    string

    任意

    クリティカルレベルのアラートの統計メソッドです。

    このパラメーターの値は、指定されたクラウドサービスの MetricName パラメーターに対応する Statistics 列によって決まります。このパラメーターの値は、Maximum、Minimum、または Average です。このパラメーターの値を取得する方法の詳細については、付録1：メトリックをご参照ください。

    説明

    クリティカル、警告、情報のいずれかのアラートレベルを少なくとも 1 つ選択し、各アラートレベルに対して Statistics、ComparisonOperator、Threshold、Times パラメーターを指定する必要があります。

    Average
    Escalations.Critical.ComparisonOperator

    string

    任意

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

    • GreaterThanOrEqualToThreshold：しきい値以上

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

    • LessThanOrEqualToThreshold：しきい値以下

    • LessThanThreshold：しきい値未満

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

    • EqualToThreshold：しきい値と等しい

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

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

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

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

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

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

    説明

    クリティカル、警告、情報のいずれかのアラートレベルを少なくとも 1 つ選択し、各アラートレベルに対して Statistics、ComparisonOperator、Threshold、Times パラメーターを指定する必要があります。

    GreaterThanOrEqualToThreshold
    Escalations.Critical.Threshold

    string

    任意

    クリティカルレベルのアラートのしきい値です。

    説明

    クリティカル、警告、情報のいずれかのアラートレベルを少なくとも 1 つ選択し、各アラートレベルに対して Statistics、ComparisonOperator、Threshold、Times パラメーターを指定する必要があります。

    90
    Escalations.Critical.Times

    integer

    任意

    メトリック値がアラート条件を満たしてからクリティカルレベルのアラートがトリガーされるまでの連続回数です。

    説明

    クリティカル、警告、情報のいずれかのアラートレベルを少なくとも 1 つ選択し、各アラートレベルに対して Statistics、ComparisonOperator、Threshold、Times パラメーターを指定する必要があります。

    3
    Escalations.Warn.Statistics

    string

    任意

    警告レベルのアラートの統計メソッドです。

    このパラメーターの値は、指定されたクラウドサービスの MetricName パラメーターに対応する Statistics 列によって決まります。このパラメーターの値は、Maximum、Minimum、または Average です。このパラメーターの値を取得する方法の詳細については、付録1：メトリックをご参照ください。

    説明

    クリティカル、警告、情報のいずれかのアラートレベルを少なくとも 1 つ選択し、各アラートレベルに対して Statistics、ComparisonOperator、Threshold、Times パラメーターを指定する必要があります。

    Average
    Escalations.Warn.ComparisonOperator

    string

    任意

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

    • GreaterThanOrEqualToThreshold：しきい値以上

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

    • LessThanOrEqualToThreshold：しきい値以下

    • LessThanThreshold：しきい値未満

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

    • EqualToThreshold：しきい値と等しい

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

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

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

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

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

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

    説明

    クリティカル、警告、情報のいずれかのアラートレベルを少なくとも 1 つ選択し、各アラートレベルに対して Statistics、ComparisonOperator、Threshold、Times パラメーターを指定する必要があります。

    GreaterThanOrEqualToThreshold
    Escalations.Warn.Threshold

    string

    任意

    警告レベルのアラートのしきい値です。

    説明

    クリティカル、警告、情報のいずれかのアラートレベルを少なくとも 1 つ選択し、各アラートレベルに対して Statistics、ComparisonOperator、Threshold、Times パラメーターを指定する必要があります。

    90
    Escalations.Warn.Times

    integer

    任意

    メトリック値がアラート条件を満たしてから警告レベルのアラートがトリガーされるまでの連続回数です。

    説明

    クリティカル、警告、情報のいずれかのアラートレベルを少なくとも 1 つ選択し、各アラートレベルに対して Statistics、ComparisonOperator、Threshold、Times パラメーターを指定する必要があります。

    3
    Escalations.Info.Statistics

    string

    任意

    情報レベルのアラートの統計メソッドです。

    このパラメーターの値は、指定されたクラウドサービスの MetricName パラメーターに対応する Statistics 列によって決まります。このパラメーターの値は、Maximum、Minimum、または Average です。このパラメーターの値を取得する方法の詳細については、付録1：メトリックをご参照ください。

    説明

    クリティカル、警告、情報のいずれかのアラートレベルを少なくとも 1 つ選択し、各アラートレベルに対して Statistics、ComparisonOperator、Threshold、Times パラメーターを指定する必要があります。

    Average
    Escalations.Info.ComparisonOperator

    string

    任意

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

    • GreaterThanOrEqualToThreshold：しきい値以上

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

    • LessThanOrEqualToThreshold：しきい値以下

    • LessThanThreshold：しきい値未満

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

    • EqualToThreshold：しきい値と等しい

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

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

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

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

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

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

    説明

    クリティカル、警告、情報のいずれかのアラートレベルを少なくとも 1 つ選択し、各アラートレベルに対して Statistics、ComparisonOperator、Threshold、Times パラメーターを指定する必要があります。

    GreaterThanOrEqualToThreshold
    Escalations.Info.Threshold

    string

    任意

    情報レベルのアラートのしきい値です。

    説明

    クリティカル、警告、情報のいずれかのアラートレベルを少なくとも 1 つ選択し、各アラートレベルに対して Statistics、ComparisonOperator、Threshold、Times パラメーターを指定する必要があります。

    90
    Escalations.Info.Times

    integer

    任意

    メトリック値がアラート条件を満たしてから情報レベルのアラートがトリガーされるまでの連続回数です。

    説明

    クリティカル、警告、情報のいずれかのアラートレベルを少なくとも 1 つ選択し、各アラートレベルに対して Statistics、ComparisonOperator、Threshold、Times パラメーターを指定する必要があります。

    3
    NoDataPolicy

    string

    任意

    モニタリングデータが見つからない場合にアラートを処理するメソッドです。有効な値：

    • KEEP_LAST_STATE (デフォルト)：操作は実行されません。

    • INSUFFICIENT_DATA：「データ不足」という内容のアラートがトリガーされます。

    • OK：ステータスは正常と見なされます。

    KEEP_LAST_STATE
    CompositeExpression

    object

    任意

    複数のメトリックのトリガー条件です。

    説明

    単一メトリックと複数メトリックのトリガー条件は相互排他です。単一メトリックと複数メトリックのトリガー条件を同時に指定することはできません。

    ExpressionList

    array<object>

    任意

    標準モードで作成されたトリガー条件です。

    object

    任意

    標準モードで作成されたトリガー条件です。

    MetricName

    string

    任意

    クラウドサービスをモニターするために使用されるメトリックです。

    cpu_total
    Period

    integer

    任意

    メトリックの集計期間です。

    単位：秒。

    60
    Statistics

    string

    任意

    メトリックの統計メソッドです。有効な値：

    • $Maximum：最大値

    • $Minimum：最小値

    • $Average：平均値

    • $Availability：可用性レート (通常はサイトモニタリングに使用)

    説明

    $ はメトリックのプレフィックスです。CloudMonitor がサポートする Alibaba Cloud サービスの詳細については、付録1：メトリックをご参照ください。

    $Maximum
    ComparisonOperator

    string

    任意

    メトリック値としきい値を比較するために使用されるオペレーターです。有効な値：

    • GreaterThanOrEqualToThreshold：しきい値以上

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

    • LessThanOrEqualToThreshold：しきい値以下

    • LessThanThreshold：しきい値未満

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

    • EqualToThreshold：しきい値と等しい

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

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

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

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

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

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

    GreaterThanOrEqualToThreshold
    Threshold

    string

    任意

    アラートのしきい値です。

    90
    ExpressionListJoin

    string

    任意

    複数のメトリックのトリガー条件間の関係です。有効な値：

    • &&：すべてのメトリックがトリガー条件を満たした場合にのみアラートがトリガーされます。ExpressionList パラメーターで指定されたすべての式の結果が true の場合にのみアラートがトリガーされます。

    • ||：いずれかのメトリックがトリガー条件を満たした場合にアラートがトリガーされます。

    ||
    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)
    Level

    string

    任意

    アラートレベルです。有効な値：

    • Critical

    • Warn

    • Info

    CRITICAL
    Times

    integer

    任意

    連続トリガー回数です。メトリック値がトリガー条件を満たす回数がこのパラメーターの値に達すると、CloudMonitor はアラート通知を送信します。

    3
    Labels

    array<object>

    任意

    メトリックがアラートルールで指定された条件を満たし、CloudMonitor がアラート通知を送信する場合、タグもメトリックに書き込まれ、アラート通知に表示されます。

    説明

    このパラメーターは、Prometheus アラートの Label パラメーターに相当します。

    object

    任意

    タグのキーです。

    Key

    string

    任意

    タグキーです。

    tagKey1
    Value

    string

    任意

    タグの値です。

    説明

    テンプレートパラメーターを使用してタグ値を指定できます。CloudMonitor は、テンプレートパラメーターの値を実際のタグ値に置き換えます。

    ECS
    Prometheus

    object

    任意

    Prometheus アラートです。

    説明

    このパラメーターは、ハイブリッドクラウド監視の Prometheus アラートルールを作成する場合にのみ必須です。

    PromQL

    string

    任意

    PromQL 文がサポートされています。

    説明

    PromQL クエリ文を使用して取得されるデータはモニタリングデータです。この文にアラートしきい値を含める必要があります。

    cpuUsage{instanceId="xxxx"}[1m]>90
    Level

    string

    任意

    アラートレベルです。有効な値：

    • Critical

    • Warn

    • Info

    CRITICAL
    Times

    integer

    任意

    連続トリガー回数です。メトリック値がトリガー条件を満たす回数がこのパラメーターの値に達すると、CloudMonitor はアラート通知を送信します。

    3
    Annotations

    array<object>

    任意

    Prometheus アラートルールのアノテーションです。Prometheus アラートがトリガーされると、システムはアノテーションされたキーと値をレンダリングして、メトリックとアラートルールの理解を助けます。

    説明

    このパラメーターは、オープンソースの Prometheus の annotations パラメーターに相当します。

    object

    任意

    Prometheus アラートルールのアノテーションです。Prometheus アラートがトリガーされると、システムはアノテーションされたキーと値をレンダリングして、メトリックとアラートルールの理解を助けます。

    Key

    string

    任意

    アノテーションのキーです。

    summary
    Value

    string

    任意

    アノテーションの値です。

    {{ $labels.instance }} CPU usage above 10% {current value: {{ humanizePercentage $value }} }

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

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    なし。

    Code

    string

    応答コードです。

    説明

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

    200
    Message

    string

    返されたメッセージです。

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

    string

    リクエスト ID です。

    65D50468-ECEF-48F1-A6E1-D952E89D9436
    Success

    boolean

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

    • true

    • false

    true

    例

    成功レスポンス

    JSONJSON

    {
  "Code": "200",
  "Message": "The request processing has failed due to some unknown error.",
  "RequestId": "65D50468-ECEF-48F1-A6E1-D952E89D9436",
  "Success": true
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    400 %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
    429 ResourceOverLimit The resource has exceeded the limit. %s

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

    変更履歴

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