调用PutEventRuleTargets添加或修改事件报警规则的推送渠道-云监控-阿里云-云监控(CMS)-阿里云帮助中心

调用PutEventRuleTargets接口添加或修改规则的推送渠道。

调试

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

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作	访问级别	资源类型	条件关键字	关联操作
cms:PutEventRuleTargets	create	全部资源 ``	无	无

请求参数

名称	类型	必填	描述	示例值
RuleName	string	是	报警规则的名称。	testEventRule
FcParameters	array<object>	否	函数计算通知方式。
	object	否	无。
FunctionName	string	否	函数名称。N 的取值范围：1~5。	fc-test
Region	string	否	函数服务对应的地域。N 的取值范围：1~5。	cn-hangzhou
ServiceName	string	否	函数服务的服务名称。N 的取值范围为 1~5。	fc-test
Id	string	否	规则发送目标的唯一标识。N 的取值范围：1~5。	1
ContactParameters	array<object>	否	报警联系组通知方式。
	object	否	无。
ContactGroupName	string	否	报警联系人组的名称。N 的取值范围：1~5。	默认报警联系组
Id	string	否	规则发送目标的唯一标识。N 的取值范围：1~5。	2
Level	string	否	报警通知级别。N 的取值范围：1~5。取值： 2：电话、短信、钉钉、邮箱 3：短信、钉钉、邮箱 4：钉钉、邮箱	4
MnsParameters	array<object>	否	轻量消息队列（原 MNS）通知。
	object	否	无。
Region	string	否	轻量消息队列（原 MNS）对应的地域。N 的取值范围：1~5。	cn-hangzhou
Queue	string	否	队列名称。N 的取值范围：1~5。	queue1
Id	string	否	规则发送目标的唯一标识。N 的取值范围：1~5。	3
Topic	string	否	轻量消息队列（原 MNS）的主题。	topic_sample
WebhookParameters	array<object>	否	URL 回调通知方式。
	object	否	无。
Protocol	string	否	协议名称。N 的取值范围：1~5。取值： http telnet ping	http
Url	string	否	回调的 URL。N 的取值范围：1~5。	http://www.aliyun.com
Method	string	否	HTTP 回调的请求方法。N 的取值范围：1~5。目前仅支持 GET 和 POST。	GET
Id	string	否	规则发送目标的唯一标识。N 的取值范围：1~5。	4
SlsParameters	array<object>	否	日志服务（SLS）通知方式。
	object	否	无。
LogStore	string	否	日志服务对应的日志库。N 的取值范围：1~5。	testlogstore
Region	string	否	日志服务对应的地域。N 的取值范围：1~5。	cn-hangzhou
Project	string	否	日志服务对应的项目。N 的取值范围：1~5。	testproject
Id	string	否	规则发送目标的唯一标识。N 的取值范围：1~5。	5
OpenApiParameters	array<object>	否	API 回调通知参数列表。
	object	否	无。
Action	string	否	API 名称。	PutLogs
Arn	string	否	资源的 ARN。N 的取值范围：1~5。格式：`arn:acs:${Service}:${Region}:${Account}:${ResourceType}/${ResourceId}`。各字段含义如下： Service：云产品。 Region：地域 ID。 Account：阿里云账号 ID。 ResourceType：资源类型。 ResourceId：资源 ID。	acs:log:cn-hangzhou::project/cms-log-mon*/logstore/cxxxx*
Id	string	否	API 回调通知方式的唯一标识。	3
Product	string	否	API 对应的云产品 ID。	log
Region	string	否	资源对应的地域。	cn-hangzhou
Role	string	否	角色名称。	MyRole
Version	string	否	API 的版本。	2019-01-01
JsonParams	string	否	报警回调的 JSON 格式参数。	{"customField1":"value1","customField2":"$.name"}

返回参数

名称	类型	描述	示例值
	object
Code	string	状态码。说明 200 表示成功。	200
Message	string	错误信息。	The Request is not authorization.
RequestId	string	请求 ID。	409C64DA-CF14-45DF-B463-471C790DD15A
Success	boolean	操作是否成功。true 表示成功，false 表示失败。	true
FailedParameterCount	string	错误参数数量统计。	2
FailedContactParameters	array<object>	如果规则发送目标中包含创建错误的报警联系人组，则返回此参数。
ContactParameter	object	无。
ContactGroupName	string	报警联系人组的名称。	默认报警联系人组
Id	integer	规则发送目标的 ID。	2
Level	string	报警通知级别。取值： 2：电话、短信、钉钉、邮箱 3：短信、钉钉、邮箱 4：钉钉、邮箱	4
FailedMnsParameters	array<object>	如果规则发送目标中包含创建错误的轻量消息队列（原 MNS），则返回此参数。
MnsParameter	object	无。
Queue	string	队列的名称。	testQueue
Id	integer	规则发送目标的 ID。	2
Region	string	地域 ID。	cn-hangzhou
FailedFcParameters	array<object>	如果规则发送目标中包含创建错误的函数服务，则返回此参数。
FcParameter	object	无。
ServiceName	string	函数服务的名称。	serviceTest1
FunctionName	string	函数名称。	functionTest1
Id	integer	规则发送目标的 ID。	1
Region	string	地域 ID。	cn-hangzhou

示例

正常返回示例

JSON格式

{
  "Code": 200,
  "Message": "The Request is not authorization.",
  "RequestId": "409C64DA-CF14-45DF-B463-471C790DD15A",
  "Success": true,
  "FailedParameterCount": 2,
  "FailedContactParameters": {
    "ContactParameter": [
      {
        "ContactGroupName": "默认报警联系人组",
        "Id": 2,
        "Level": 4
      }
    ]
  },
  "FailedMnsParameters": {
    "MnsParameter": [
      {
        "Queue": "testQueue",
        "Id": 2,
        "Region": "cn-hangzhou"
      }
    ]
  },
  "FailedFcParameters": {
    "FcParameter": [
      {
        "ServiceName": "serviceTest1",
        "FunctionName": "functionTest1",
        "Id": 1,
        "Region": "cn-hangzhou"
      }
    ]
  }
}

错误码

HTTP status code	错误码	错误信息
400	%s	%s
500	InternalError	The request processing has failed due to some unknown error.

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

变更历史

变更时间	变更内容概要	操作
2021-12-22	OpenAPI 描述信息更新、OpenAPI 错误码发生变更	查看变更详情