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

Cloud Monitor:DescribeMetricRuleTargets

最終更新日:Jun 14, 2026

DescribeMetricRuleTargets 操作を呼び出して、指定されたアラートルールの通知チャネルを照会します。

操作説明

使用上の注意

この Topic では、アラートルール ae06917_75a8c43178ab66**** に関連付けられたターゲットリソースをクエリする例を示します。

今すぐお試しください

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

list

*All Resource

*

なし なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

RuleId

string

必須

アラートルールの ID。

アラートルール ID の取得方法については、 DescribeMetricRuleList を参照してください。

ae06917_75a8c43178ab66****

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

レスポンスフィールド

フィールド

説明

object

Code

string

状態コード。

説明

値 200 は成功を示します。

200

Message

string

エラーメッセージ。

User not authorized to operate on the specified resource.

RequestId

string

リクエスト ID。

786E92D2-AC66-4250-B76F-F1E2FCDDBA1C

Success

boolean

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

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

  • false: 操作が失敗しました。

true

Targets

object

Target

array<object>

アラートトリガーターゲット。

object

アラートトリガーターゲット。

Id

string

アラートがトリガーされるリソースの ID。

1

Arn

string

リソースの Alibaba Cloud リソースネーム (ARN)。 フォーマット: acs:{Service name abbreviation}:{regionId}:{userId}:/{Resource type}/{Resource name}/message。 例: acs:mns:cn-hangzhou:120886317861****:/queues/test123/message。 フィールド:

  • {Service name abbreviation}:サービス名の省略形。 有効な値:mns。

  • {userId}:Alibaba Cloud アカウントの ID。

  • {regionId}:メッセージキューまたは Topic のリージョン ID。

  • {Resource type}:アラートがトリガーされるリソースのタイプ。 有効な値: - **queues** - **topics** {Resource name}:リソースの名前。 - リソースタイプが **queues** に設定されている場合、リソース名はメッセージキューの名前です。 - リソースタイプが **topics** に設定されている場合、リソース名は Topic の名前です。

acs:mns:cn-hangzhou:120886317861****:/queues/test/message

Level

string

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

  • INFO:情報

  • WARN:警告

  • CRITICAL:重大

INFO

JsonParams

string

アラートコールバックのパラメーター。 パラメーターは JSON フォーマットです。

{"customField1":"value1","customField2":"$.name"}

成功レスポンス

JSONJSON

{
  "Code": "200",
  "Message": "User not authorized to operate on the specified resource.",
  "RequestId": "786E92D2-AC66-4250-B76F-F1E2FCDDBA1C",
  "Success": true,
  "Targets": {
    "Target": [
      {
        "Id": "1",
        "Arn": "acs:mns:cn-hangzhou:120886317861****:/queues/test/message",
        "Level": "INFO",
        "JsonParams": "{\"customField1\":\"value1\",\"customField2\":\"$.name\"}"
      }
    ]
  }
}

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

400 InvalidParameterValue %s
400 %s %s
500 InternalError %s
403 AccessForbidden User not authorized to operate on the specified resource.

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

変更履歴

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