すべてのプロダクト
Search

このプロダクト

    Cloud Monitor:PutCustomMetricRule

    ドキュメントセンター

    Cloud Monitor:PutCustomMetricRule

    最終更新日:Jun 26, 2026

    カスタム監視のアラートルールを作成します。

    操作説明

    この操作を呼び出す前に、PutCustomMetric 操作を呼び出してカスタム監視データをレポートしてください。詳細については、 PutCustomMetric を参照してください。

    今すぐお試しください

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

    create

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    GroupId

    string

    任意

    カスタム監視データが属するアプリケーショングループの ID。

    説明

    値が 0 の場合、レポートされたカスタム監視データはどのアプリケーショングループにも属していないことを示します。

    7378****
    RuleId

    string

    必須

    アラートルールの ID。

    説明

    アラートルール ID が既に存在する場合、アラートルールが変更されます。アラートルール ID が存在しない場合、アラートルールが作成されます。

    MyRuleId1
    RuleName

    string

    任意

    アラートルールの名前。

    CpuUsage
    MetricName

    string

    必須

    メトリックの名前。

    説明

    メトリック名の取得方法については、 DescribeCustomMetricList を参照してください。

    cpu_total
    Resources

    string

    必須

    アラートルールが適用されるカスタム監視データ。値は、カスタム監視データが属するアプリケーショングループ ID とメトリックのディメンションで構成されます。

    [{"groupId":7378****,"dimension":"instanceId=i-hp3543t5e4sudb3s****"}]
    ContactGroups

    string

    必須

    アラート連絡先グループ。複数のアラート連絡先グループはコンマ (,) で区切ります。

    ECS_Group
    Webhook

    string

    任意

    アラートがトリガーされたときに呼び出される Webhook URL。この URL に POST リクエストが送信されます。

    https://www.aliyun.com
    EffectiveInterval

    string

    任意

    アラートルールが有効な時間範囲。有効値: 00:00-23:59。

    00:00-23:59
    SilenceTime

    integer

    任意

    ミュート期間。単位: 秒。デフォルト値: 86400 (1 日)。

    説明

    モニタリングデータがアラートルールのしきい値を継続的に超えた場合、各ミュート期間内にアラート通知は 1 件のみ送信されます。

    86400
    Period

    string

    任意

    カスタム監視データの集計期間。単位: 秒。値は 60 または 60 の倍数である必要があります。デフォルト値: カスタム監視データの元のレポート期間。

    300
    EmailSubject

    string

    任意

    アラートメールの主題。

    ECS instance
    Threshold

    string

    必須

    アラートのしきい値。

    90
    Level

    string

    必須

    アラートの重大度レベル。有効な値:

    • CRITICAL: 重大。

    • WARN: 警告。

    • INFO: 情報。

    CRITICAL
    EvaluationCount

    integer

    必須

    アラートのリトライ回数。

    3
    Statistics

    string

    必須

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

    Average
    ComparisonOperator

    string

    必須

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

    • >=

    • =

    • <=

    • >

    • <

    • !=。

    >=

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    Code

    string

    HTTP 状態コード。

    説明

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

    200
    Message

    string

    返されたメッセージ。呼び出しが成功した場合、このパラメーターは空です。呼び出しが失敗した場合、エラーメッセージが返されます。

    ComparisonOperator is mandatory for this action.
    RequestId

    string

    リクエスト ID。

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

    boolean

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

    • true: 成功。

    • false: 失敗した。

    true

    例

    成功レスポンス

    JSONJSON

    {
  "Code": "200",
  "Message": "ComparisonOperator is mandatory for this action.",
  "RequestId": "65D50468-ECEF-48F1-A6E1-D952E89D9432",
  "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

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

    変更履歴

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