更新通知配置 - UpdateAlarmRule

project_id

是

String

参数解释：

项目ID，获取方法请参见项目ID和账号ID。

约束限制：

32字符。

取值范围：

小写字母、数字。

默认取值：

不涉及。

id

是

String

参数解释：

告警规则ID，用于唯一标识一条告警规则，在更新通知配置场景中指定要修改的告警规则。可以通过调用“查询通知规则列表”接口获取。

约束限制：

字符长度1-64。

取值范围：

数字、字母、中横线。

默认取值：

不涉及。

X-Auth-Token

否

String

参数解释：

IAM Token，通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。

约束限制：

使用Token认证时必选，最大长度4096。

取值范围：

不涉及。

默认取值：

不涉及。

workspace

是

String

参数解释：

工作空间ID，获取方法请参见实例ID和工作空间ID。

约束限制：

最大128字符。

取值范围：

不涉及。

默认取值：

不涉及。

node_id

是

Long

参数解释：

节点ID，用于标识告警规则关联的节点。配置后告警将监控该节点的运行状态。

约束限制：

必填参数。

取值范围：

按规则类型不同，取值不同。

• 作业规则：取值为作业id。可通过调用“查询作业列表”接口获取。

• 所有作业：固定取值-1。

• 目录规则：固定取值-2。

默认取值：

不涉及。

node_name

否

String

参数解释：

节点名，用于标识告警规则关联的节点。配置后告警将监控该节点的运行状态。

约束限制：

最大128字符，修改单个作业通知时必填。

取值范围：

中文、英文、中横线、下划线和点号。

默认取值：

不涉及。

node_type

是

String

参数解释：

节点类型，指定告警规则关联的节点类型。固定值为1，表示作业节点。

约束限制：

只能取值1，必填参数。

取值范围：

1（作业节点）。

默认取值：

不涉及。

notify_type

否

Integer

参数解释：

提醒类型，指定告警提醒的发送方式。配置后系统将按照该方式发送告警通知。

约束限制：

无。

取值范围：

• 0：消息。

默认取值：

0。

remind_type

是

Integer

参数解释：

通知类型。配置后系统将按照该方式在告警触发时发送提醒。

约束限制：

必填参数。

取值范围：

• 0：运行成功。

• 1：运行异常/失败。

• 3：未完成。

• 4：资源繁忙。

• 13：运行取消。

• 14：失败重跑作业成功。

• 15：作业改动。

• 16：yarn执行超时查杀。

• 17: 未启动。

• 18：超过7天平均时长。

默认取值：

不涉及。

use_flag

是

Integer

参数解释：

启用标志，指定告警规则是否启用。配置为0表示禁用告警规则，配置为1表示启用告警规则。

约束限制：

必填参数。

取值范围：

0（禁用）或1（启用）。

默认取值：

不涉及。

notify_method

否

String

参数解释：

告警方式。

约束限制：

不涉及。

取值范围：

• SUBJECT：主题。

• OWNER：责任人。

• DUTY_SCHEDULE：值班表。

• DINGDING：钉钉机器人。

默认取值：

不涉及。

complete_time

否

String

参数解释：

作业完成时间阈值，未完成时触发告警。remind_type为3（未完成）时填写。

约束限制：

不涉及。

取值范围：

格式为HH:mm的时间字符串，例如10:00。

默认取值：

不涉及。

max_send_times

否

Integer

参数解释：

最大通知次数，指定告警通知的最大发送次数。配置后系统在告警触发时最多发送该次数的通知。

约束限制：

不涉及。

取值范围：

普通告警取值范围为1-50整数。持续告警为固定值9999。

默认取值：

不涉及。

send_interval

否

Integer

参数解释：

通知间隔，指定告警通知的发送间隔时间，单位为分钟。配置后系统将按照该间隔重复发送告警通知。

约束限制：

不涉及。

取值范围：

5-60整数。

默认取值：

不涉及。

topic_name

否

String

参数解释：

SMN主题名称，用于指定消息通知的主题。配置后告警通知将发送到该SMN主题。需要先在SMN服务中创建主题，可以通过SMN控制台或调用"查询SMN主题列表"接口获取。

约束限制：

只能以字母或数字开头，只能包含字母、数字、下划线和连字符，长度为1-256个字符。

取值范围：

符合正则表达式^[a-zA-Z\d][a-zA-Z\d-_]{0,255}$的字符串。

默认取值：

不涉及。

other_persons

否

Array of strings

参数解释：

抄送人用户名列表，最多支持抄送10个用户。

约束限制：

不涉及。

duty_schedule_id

否

Long

参数解释：

值班表ID，指定告警通知关联的值班表。notify_method为DUTY_SCHEDULE时填写。

约束限制：

不涉及。

取值范围：

正整数。

默认取值：

不涉及。

smn_config_id

否

String

参数解释：

SMN配置ID，指定告警通知关联的SMN配置。notify_method为DINGDING时填写。

约束限制：

不超过32字符。

取值范围：

字符串。

默认取值：

不涉及。

rule_name

否

String

参数解释：

规则名称，使用目录规则时需填写。

约束限制：

最长64字符。

取值范围：

中文、英文、中横线、下划线和点号。

默认取值：

不涉及。

job_directory

否

Array of DirectoryDTO objects

参数解释：

作业目录信息，使用目录规则时需填写。

约束限制：

不涉及。

protocol

否

Array of strings

参数解释：

通知协议列表。

约束限制：

不涉及。

subject_type

否

String

参数解释：

通知对象类型。

约束限制：

修改目录规则类型通知时必填。

取值范围：

• DIRECTORY_RULE：目录规则

默认取值：

不涉及。

exceed_duration

否

Long

参数解释：

超时时长，单位毫秒。remind_type为18（超过7天平均时长）时填写。

约束限制：

不涉及。

取值范围：

正整数。

默认取值：

不涉及。

enable_recovery

否

Boolean

参数解释：

是否开启恢复通知。开启后，当作业失败后重跑成功时发送恢复通知。

约束限制：

仅对remind_type=1（运行异常）的规则生效。

取值范围：

true或false。

默认取值：

不涉及。

add_mode

否

String

参数解释：

添加类型。

约束限制：

仅更新目录规则时必填。

取值范围：

• BATCH_ADD：批量添加

默认取值：

不涉及。

directory_id

否

String

参数解释：

目录ID。

约束限制：

长度小于等于64字符。

取值范围：

字母、数字、和中划线。

默认取值：

不涉及。

directory_name

否

String

参数解释：

目录名称。

约束限制：

长度小于等于64个字符。

取值范围：

字母、数字、中文、下划线和中划线。

默认取值：

不涉及。

error_code

String

参数解释：

错误码。

取值范围：

不涉及。

error_msg

String

参数解释：

错误描述。

取值范围：

不涉及。

200

更新成功。

400

BadRequest