All Products
Search
Document Center

DataWorks:CreateDataQualityAlertRule

Last Updated:Dec 19, 2025

Creates a data quality monitoring alert rule in a project.

Operation description

This API operation is available for all DataWorks editions.

Debugging

You can run this interface directly in OpenAPI Explorer, saving you the trouble of calculating signatures. After running successfully, OpenAPI Explorer can automatically generate SDK code samples.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
ProjectIdlongYes

The project ID.

10001
ConditionstringYes

The alert condition of the data quality monitoring rule.

results.any { r -> r.status == 'fail' && r.rule.severity == 'High' }
TargetobjectYes

The monitored target of the data quality monitoring rule.

TypestringYes

The type of the monitored target. Only DataQualityScan is supported.

DataQualityScan
IdsarrayYes

The list of monitored target IDs. Currently, only one ID can be set.

longYes

The ID of the monitored target.

113646
NotificationobjectYes

The list of alert channels.

ChannelsarrayYes

The list of alert channels. You can set both Email and Sms at the same time. In other cases, only one channel can be set.

stringYes

Alert channels.

  • Dingding
  • Weixin
  • Mail
  • Sms
  • Phone
  • Webhook
  • Feishu
Sms
Receiversarray<object>Yes

The alert recipients.

objectYes

The alert recipients.

ExtensionstringNo

Additional configurations required for the alert recipients. When ReceiverType is DingdingUrl, you can set {"atAll":true} to mention all members.

{"atAll":true}
ReceiverTypestringYes

The type of alert recipients.

  • AliUid
  • WebhookUrl
  • DingdingUrl
  • WeixinUrl
  • FeishuUrl
  • TaskOwner
  • DataQualityScanOwner
  • ShiftSchedule
TaskOwner
ReceiverValuesarrayNo

The value of alert recipients.

stringNo

The value of alert recipients.

  • If ReceiverType is AliUid, enter the Alibaba Cloud account ID.
  • If ReceiverType is ShiftSchedule, enter the shift schedule ID.
  • If ReceiverType is WebhookUrl / DingdingUrl / FeishuUrl / WeixinUrl, enter the corresponding URL.
https://oapi.dingtalk.com/robot/send?access_token=a30bae7******

Response parameters

ParameterTypeDescriptionExample
object

The response.

RequestIdstring

The request ID.

0bc14115***159376359
Idlong

The user-defined rule ID returned after the monitoring rule is successfully created.

1010543619

Examples

Sample success responses

JSONformat

{
  "RequestId": "0bc14115***159376359",
  "Id": 1010543619
}

Error codes

For a list of error codes, visit the Service error codes.