调用PutMetricRuleTargets接口为指定报警规则添加或修改关联资源。

使用限制

目前仅支持消息服务MNS。

使用说明

本文将提供一个示例，为报警规则ae06917_75a8c43178ab66****关联资源acs:mns:cn-hangzhou:120886317861****:/queues/test/message，报警触发目标ID为1。返回结果显示，添加关联资源成功。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 PutMetricRuleTargets

要执行的操作，取值：PutMetricRuleTargets。

RuleId String 是 ae06917_75a8c43178ab66****

报警规则ID。

关于如何获取报警规则ID，请参见DescribeMetricRuleList。

Targets.N.Id String 是 1

报警触发目标ID。

关于如何获取报警触发目标ID，请参见DescribeMetricRuleTargets。

Targets.N.Arn String 是 acs:mns:cn-hangzhou:120886317861****:/queues/test/message

资源ARN。

关于如何获取资源ARN，请参见DescribeMetricRuleTargets。

资源ARN的格式为acs:{云产品缩写}:{regionId}:{userId}:/{资源类型}/{资源名称}/message。例如：acs:mns:cn-hangzhou:120886317861****:/queues/test123/message。参数说明如下：

  • {云产品缩写}：目前仅支持消息服务MNS。
  • {userId}：阿里云账号ID。
  • {regionId}：消息队列或主题所在地域。
  • {资源类型}：接收报警的资源类型。取值： - **queues**：队列。 - **topics**：主题。 - {资源名称}：资源名称。 - 如果资源类型为**queues**，则资源名称为队列名称。 - 如果资源类型为**topics**，则资源名称为主题名称。
Targets.N.Level String 否 ["INFO", "WARN", "CRITICAL"]

报警级别。取值：

  • INFO：信息。
  • WARN：警告。
  • CRITICAL：紧急。
Targets.N.JsonParams String 否 {"customField1":"value1","customField2":"$.name"}

报警回调的JSON格式参数。

关于公共请求参数的详情，请参见公共参数。

返回数据

名称 类型 示例值 描述
Code String 200

状态码。

说明 200表示成功。
Message String The request processing has failed due to some unknown error.

错误信息。
RequestId String 6A569B0D-9055-58AF-9E82-BAEAF95C0FD5

请求ID。
Success Boolean true

操作是否成功。取值：

  • true：成功。
  • false：失败。
FailData Object

失败列表。
Targets Array of Target

报警触发目标。
Target
Id String 1

报警触发目标ID。
Arn String acs:mns:cn-hangzhou:111:/queues/test/message

资源ARN。

格式为acs:{云产品缩写}:{regionId}:{userId}:/{资源类型}/{资源名称}/message。例如：acs:mns:cn-hangzhou:120886317861****:/queues/test123/message。参数说明如下：

  • {云产品缩写}：目前仅支持消息服务MNS。
  • {userId}：阿里云账号ID。
  • {regionId}：消息队列或主题所在地域。
  • {资源类型}：接收报警的资源类型。取值： - **queues**：队列。 - **topics**：主题。 - {资源名称}：资源名称。 - 如果资源类型为**queues**，则资源名称为队列名称。 - 如果资源类型为**topics**，则资源名称为主题名称。
Level String ["INFO", "WARN", "CRITICAL"]

报警级别。取值：

  • INFO：信息。
  • WARN：警告。
  • CRITICAL：紧急。

示例

请求示例

http(s)://[Endpoint]/?Action=PutMetricRuleTargets
&RuleId=ae06917_75a8c43178ab66****
&Targets.1.Arn=acs:mns:cn-hangzhou:120886317861****:/queues/test/message
&Targets.1.Id=1
&<公共请求参数>

正常返回示例

XML格式 

HTTP/1.1 200 OK
Content-Type:application/xml

<PutMetricRuleTargetsResponse>
	<RequestId>6A569B0D-9055-58AF-9E82-BAEAF95C0FD5</RequestId>
	<Code>200</Code>
	<Success>true</Success>
</PutMetricRuleTargetsResponse>

JSON格式 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "6A569B0D-9055-58AF-9E82-BAEAF95C0FD5",
  "Code" : "200",
  "Success" : true
}

错误码

访问错误中心查看更多错误码。