全部产品
Search
文档中心

大数据开发治理平台 DataWorks:CreateDIAlarmRule - 创建告警规则

更新时间:Dec 11, 2024

创建数据集成报警规则。

调试

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

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
Descriptionstring

描述。

告警描述
MetricTypestring

告警指标类型,可选的枚举值:

  • Heartbeat(任务状态报警)
  • FailoverCount(failover 次数报警)
  • Delay(任务延迟报警)
  • DdlReport(DDL 通知)
  • ResourceUtilization(资源组使用率)
Heartbeat
Enabledboolean

告警规则是否启用,默认不开启。

true
DIJobIdlong

任务 ID,是告警规则关联的任务 ID。

1
ClientTokenstring

幂等参数

ABFUOEUOTRTRJKE
Namestring

告警规则名称。

alartRule
TriggerConditionsarray<object>

告警触发条件列表,支持多条件。

object

告警触发条件列表,支持多条件。

Severitystring

严重程度,可选的枚举值:

  • Warning
  • Critical
Warning
Durationlong

告警计算时间区间,单位分钟。

10
Thresholdlong

告警阈值。

  • 任务状态报警:无需填写阈值。
  • failover 次数报警:阈值为 failover 次数。
  • 任务延迟报警:阈值为延迟时长,单位秒。
10
DdlReportTagsarray

在 DDL 通知的时候才生效,需要生效的 DDL 列表。

string

在 MetricType 配置为 DdlReport 时才返回需要生效的 DDL 列表,包括

  • AlterAddColumn 加列
  • AlterDropColumn 删列
  • AlterRenameColumn 修改列名
  • AlterRenameTable 修改表名
  • AlterTableModify 其他修改表
  • DropTable 删除表
  • TruncateTable 清空表
AlterAddColumn
NotificationSettingsobject

告警通知设置。

NotificationChannelsarray<object>

告警通知渠道。

object

告警通知渠道。

Severitystring

严重程度,可选的枚举值:

  • Warning
  • Critical
Warning
Channelsarray

通道,可选的枚举值:

  • Mail(邮件)
  • Phone(电话)
  • Sms(短信)
  • Ding(钉钉)
string

通道,可选的枚举值:

  • Mail(邮件)
  • Phone(电话)
  • Sms(短信)
  • Ding(钉钉)
Ding
NotificationReceiversarray<object>

告警通知接收方。

object

告警通知接收方。

ReceiverTypestring

接收方类型,取值范围:AliyunUid/DingToken/FeishuToken/WebHookUrl

DingToken
ReceiverValuesarray

接收方取值。

  • 当接收方类型为阿里云 ID 时,接收方取值为具体阿里云用户 ID。
  • 当接收方类型为钉钉 token 时,接收方取值为具体钉钉 token 值。
string

接收方取值。

  • 当接收方类型为阿里云 ID 时,接收方取值为具体阿里云用户 ID。
  • 当接收方类型为钉钉 token 时,接收方取值为具体钉钉 token 值。
token1
InhibitionIntervalinteger

告警抑制间隔时长,单位分钟,默认 5 分钟。

5

返回参数

名称类型描述示例值
object

Schema of Response

DIAlarmRuleIdstring

告警规则 ID。

1
RequestIdstring

请求的 ID。用于定位日志,排查问题。

C636A747-7E4E-594D-94CD-2B4F8A9A9A63

示例

正常返回示例

JSON格式

{
  "DIAlarmRuleId": "1",
  "RequestId": "C636A747-7E4E-594D-94CD-2B4F8A9A9A63"
}

错误码

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

变更历史

变更时间变更内容概要操作
暂无变更历史