GetAlertRule - 获取自定义监控告警规则 - 大数据开发治理平台 DataWorks

获取自定义监控告警规则。

调试

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

授权信息

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

请求参数

名称	类型	必填	描述	示例值

名称	类型	必填	描述	示例值
Id	string	否	自定义告警规则 ID。	28547072

返回参数

名称	类型	描述	示例值

名称	类型	描述	示例值
	object	Schema of Response
RequestId	string	请求的 ID，用于定位日志、排查问题。	8abcb91f-d266-4073-b907-2ed****
AlertRule	object	自定义规则详情。
Id	long	自定义规则 ID。	16035
Name	string	自定义规则名。	error_rule
Owner	string	自定义规则的责任人阿里云 UID。	279961421580845157
Enabled	boolean	告警规则是否启用。	true
Notification	object	告警通知配置。
SilenceStartTime	string	静默开始时间，格式为 HH:mm:ss 。	00:00:00
SilenceEndTime	string	静默结束时间，格式为 HH:mm:ss 。	00:00:00
IntervalInMinutes	integer	告警间隔，单位为分钟，取值范围[5,10000]。	30
Maximum	integer	一个自然日内的告警最大次数，取值范围[1, 10000]。	3
Channels	array	告警通道列表。
Channels	string	告警通道，枚举值： Mail: 邮件 Phone: 电话 Sms: 短信 Dingding: 钉钉 webhook Feishu: 飞书 webhook Weixin: 企业微信 webhook Webhook: 自定义 Webhook	Sms
Receivers	array<object>	告警接收对象。
Receivers	object
ReceiverType	string	告警接收对象类型，枚举值： AliUid: 阿里云 UID ShiftSchedule: 值班表 TaskOwner: 任务责任人，适用于自定义告警和事件告警 Owner: 责任人，适用于基线告警 WebhookUrl: 自定义 webhookUrl DingdingUrl: 钉钉 webhookUrl FeishuUrl: 飞书 webhookUrl WeixinUrl: 企业微信 webhookUrl	WebhookUrl
ReceiverValues	array	告警接收对象值。
ReceiverValues	string	告警接收对象值。当 ReceiverType 为 AliUid 时填阿里云 UID，为 ShiftSchedule 时填值班表 ID，为 WebhookUrl / DingdingUrl / FeishuUrl / WeixinUrl 时填入对应的 URL。	123123123
Extension	string	告警对象需要的额外配置，当 ReceiverType 为 DingdingUrl，支持设置 {"atAll":true} @所有人。	{"atAll":true}
TriggerCondition	object	触发告警的条件。
Type	string	触发报警的类型，枚举值： Finished: 实例完成 UnFinished: 实例未完成 Error: 实例出错 CycleUnfinished: 实例周期未完成 Timeout: 实例超时 InstanceTransferComplete: 任务转实例完成 InstanceTransferFluctuate: 实例数量波动 ExhaustedError: 自动重跑后仍出错 InstanceKeyword: 出错实例包含关键词 InstanceErrorCount: 出错实例数量 InstanceErrorPercentage: 出错实例占比 ResourceGroupPercentage: 资源组利用率 ResourceGroupWaitCount: 资源组等资源实例数	Error
Extension	object	扩展信息，部分触发条件需要配置。
Error	object	出错告警配置。
StreamTaskIds	array	监控实时计算任务时，填入对应的任务 ID。
StreamTaskIds	long	实时计算任务 ID。	123123
AutoRerunAlertEnabled	boolean	离线任务由于失败自动重跑，是否产生告警。	false
Timeout	object	超时告警配置。
TimeoutInMinutes	integer	超时时间，单位为分钟。	10
UnFinished	object	未完成告警配置。
UnFinishedTime	string	未完成时间，格式为 hh:mm，hh 的取值范围为[0,47]，mm 的取值范围为[0,59]。	12:00
CycleUnfinished	object	周期未完成告警配置。
CycleAndTime	array<object>	周期和时间配置列表。
CycleAndTime	object
CycleId	integer	周期 ID，取值范围为[1,288]。	1
Time	string	超时时间，格式为 hh:mm，hh 的取值范围为[0,47]，mm 的取值范围为[0,59]。	12:00
InstanceErrorCount	object	实例出错数量告警配置。
Count	integer	出错的实例数，取值范围为[1,10000]。	10
InstanceErrorPercentage	object	实例出错比例告警配置。
Percentage	integer	出错实例占比，取值范围 [1-100]。	10
InstanceTransferFluctuate	object	转实例数量波动告警配置。
Trend	string	转实例波动类型，枚举值： abs: 绝对值 increase: 增长 decrease: 下降	10
Percentage	integer	转实例波动百分比，取值范围[1-100]。	10
Target	object	监控对象。
Type	string	监控对象类型，枚举值： Task: 任务节点 Baseline: 基线 Project: 工作空间 BizProcess - 业务流程	Task
Ids	array	监控对象 ID 列表。
Ids	long	监控对象 ID。	32570
AllowTasks	array	监控任务白名单列表。
AllowTasks	long	监控任务白名单 ID。	123123

示例

正常返回示例

JSON格式

            
            
          
{
  "RequestId": "8abcb91f-d266-4073-b907-2ed****",
  "AlertRule": {
    "Id": 16035,
    "Name": "error_rule",
    "Owner": "279961421580845157",
    "Enabled": true,
    "Notification": {
      "SilenceStartTime": "00:00:00",
      "SilenceEndTime": "00:00:00",
      "IntervalInMinutes": 30,
      "Maximum": 3,
      "Channels": [
        "Sms"
      ],
      "Receivers": [
        {
          "ReceiverType": "WebhookUrl",
          "ReceiverValues": [
            "123123123"
          ],
          "Extension": "{\"atAll\":true}"
        }
      ]
    },
    "TriggerCondition": {
      "Type": "Error",
      "Extension": {
        "Error": {
          "StreamTaskIds": [
            123123
          ],
          "AutoRerunAlertEnabled": false
        },
        "Timeout": {
          "TimeoutInMinutes": 10
        },
        "UnFinished": {
          "UnFinishedTime": "12:00"
        },
        "CycleUnfinished": {
          "CycleAndTime": [
            {
              "CycleId": 1,
              "Time": "12:00"
            }
          ]
        },
        "InstanceErrorCount": {
          "Count": 10
        },
        "InstanceErrorPercentage": {
          "Percentage": 10
        },
        "InstanceTransferFluctuate": {
          "Trend": "10",
          "Percentage": 10
        }
      },
      "Target": {
        "Type": "Task",
        "Ids": [
          32570
        ],
        "AllowTasks": [
          123123
        ]
      }
    }
  }
}

错误码

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

变更历史

变更时间	变更内容概要	操作

变更时间	变更内容概要	操作
2024-12-27	OpenAPI 返回结构发生变更	查看变更详情