ListAlertRules - 获取自定义规则列表

分页获取自定义监控告警规则

调试

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

授权信息

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

请求参数

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

自定义规则的责任人阿里云 UID。

1933790683****
TaskIdsarray

调度任务 ID 列表

long

调度任务 ID。

1234
Typesarray

触发告警的类型列表。

string

触发告警的类型,枚举值:

  • Finished: 实例完成
  • UnFinished: 实例未完成
  • Error: 实例出错
  • CycleUnfinished: 实例周期未完成
  • Timeout: 实例超时
  • InstanceTransferComplete: 任务转实例完成
  • InstanceTransferFluctuate: 实例数量波动
  • ExhaustedError: 自动重跑后仍出错
  • InstanceKeyword: 出错实例包含关键词
  • InstanceErrorCount: 出错实例数量
  • InstanceErrorPercentage: 出错实例占比
  • ResourceGroupPercentage: 资源组利用率
  • ResourceGroupWaitCount: 资源组等资源实例数
Error
Receiverstring

告警接收人阿里云 UID。

1933790683****
Namestring

自定义规则名

error_rule
PageNumberinteger

页码数,用于翻页,最小值为 1。

1
PageSizelong

每页显示的条数,最大 100 条。

10

返回参数

名称类型描述示例值
object

Schema of Response

RequestIdstring

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

A6C6B486-E3A2-5D52-9E76-D9380485D946
PagingInfoobject

分页信息。

TotalCountinteger

满足条件的数据总条数。

5
PageNumberinteger

请求的数据页数,用于翻页。

1
PageSizeinteger

每页显示的条数。

10
AlertRulesarray<object>

一组自定义规则。

AlertRulesobject
Idlong

自定义规则 ID。

22125
Namestring

自定义规则名。

error_test
Ownerstring

自定义规则的责任人阿里云 UID。

1933790683****
Enabledboolean

告警规则是否启用。

true
TriggerConditionobject

触发告警的条件。

Typestring

触发告警的类型,枚举值:

  • Finished: 实例完成
  • UnFinished: 实例未完成
  • Error: 实例出错
  • CycleUnfinished: 实例周期未完成
  • Timeout: 实例超时
  • InstanceTransferComplete: 任务转实例完成
  • InstanceTransferFluctuate: 实例数量波动
  • ExhaustedError: 自动重跑后仍出错
  • InstanceKeyword: 出错实例包含关键词
  • InstanceErrorCount: 出错实例数量
  • InstanceErrorPercentage: 出错实例占比
  • ResourceGroupPercentage: 资源组利用率
  • ResourceGroupWaitCount: 资源组等资源实例数
Error
Extensionobject

扩展信息,部分触发条件需要配置。

Errorobject

出错告警配置。

StreamTaskIdsarray

实时计算任务监控时填入对应的任务 ID

StreamTaskIdslong

实时计算任务 ID

123
AutoRerunAlertboolean

离线任务由于失败自动重跑,是否产生告警

false
Timeoutobject

超时告警配置

TimeoutInMinutesinteger

超时时间,单位为分钟。

10
UnFinishedobject

未完成告警配置。

UnFinishedTimestring

未完成时间,格式为 hh:mm,hh 的取值范围为[0,47],mm 的取值范围为[0,59]。

12:00
CycleUnfinishedobject

周期未完成告警配置。

CycleAndTimearray<object>

周期和时间配置列表。

CycleAndTimeobject
CycleIdinteger

周期 ID,取值范围为[1,288]。

1
Timestring

未完成时间,格式为 hh:mm,hh 的取值范围为[0,47],mm 的取值范围为[0,59]。

01:00
InstanceErrorCountobject

任务实例出错数量告警配置。

Countinteger

出错的任务实例数,取值范围为[1,10000]。

10
InstanceErrorPercentageobject

任务实例出错比例告警配置。

Percentageinteger

出错实例占比,取值范围 [1-100]。

10
InstanceTransferFluctuateobject

转实例数量波动告警配置。

Trendstring

转实例波动类型,枚举值:

  • abs: 绝对值
  • increase: 增长
  • decrease: 下降
abs
Percentageinteger

转实例波动百分比,取值范围[1-100]。

10
Targetobject

监控对象。

Typestring

监控对象类型,枚举值:

  • Task: 任务节点
  • Baseline: 基线
  • Projec: 工作空间
  • BizProcess - 业务流程
Task
Idsarray

监控对象 ID 列表。

Idslong

监控对象 ID。

32567
AllowTasksarray

监控任务白名单列表。

AllowTaskslong

监控任务白名单 ID。

123123

示例

正常返回示例

JSON格式

{
  "RequestId": "A6C6B486-E3A2-5D52-9E76-D9380485D946",
  "PagingInfo": {
    "TotalCount": 5,
    "PageNumber": 1,
    "PageSize": 10,
    "AlertRules": [
      {
        "Id": 22125,
        "Name": "error_test",
        "Owner": "1933790683****",
        "Enabled": true,
        "TriggerCondition": {
          "Type": "Error",
          "Extension": {
            "Error": {
              "StreamTaskIds": [
                123
              ],
              "AutoRerunAlert": false
            },
            "Timeout": {
              "TimeoutInMinutes": 10
            },
            "UnFinished": {
              "UnFinishedTime": "12:00"
            },
            "CycleUnfinished": {
              "CycleAndTime": [
                {
                  "CycleId": 1,
                  "Time": "01:00"
                }
              ]
            },
            "InstanceErrorCount": {
              "Count": 10
            },
            "InstanceErrorPercentage": {
              "Percentage": 10
            },
            "InstanceTransferFluctuate": {
              "Trend": "abs",
              "Percentage": 10
            }
          },
          "Target": {
            "Type": "Task",
            "Ids": [
              32567
            ],
            "AllowTasks": [
              123123
            ]
          }
        }
      }
    ]
  }
}

错误码

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