Modifies a custom alert rule.
Debugging
Authorization information
Request parameters
Parameter | Type | Required | Description | Example |
---|---|---|---|---|
RemindId | long | Yes | The custom alert rule ID. | 1234 |
RemindName | string | No | The name of the custom alert rule. The name cannot exceed 128 characters in length. | update_remindname |
DndEnd | string | No | The end of the period during which no alert notifications are sent. Specify the time in the hh:mm format. Valid values of hh: [0,23]. Valid values of mm: [0,59]. | 08:00 |
RemindUnit | string | No | The type of the object to which the custom alert rule is applied. Valid values:
| NODE |
NodeIds | string | No | The ID of the node to which the custom alert rule is applied. A maximum of 50 nodes can be specified for a custom alert rule. You can specify multiple IDs. Separate multiple IDs with commas (,). This parameter takes effect when you set the RemindUnit parameter to NODE. | 1,2,3 |
BaselineIds | string | No | The ID of the baseline to which the custom alert rule is applied. A maximum of 5 baselines can be specified for a custom alert rule. You can specify multiple IDs. Separate multiple IDs with commas (,). This parameter takes effect when you set the RemindUnit parameter to BASELINE. | 1,2,3 |
ProjectId | long | No | The ID of the workspace to which the custom alert rule is applied. You can specify only one workspace for a custom alert rule. This parameter takes effect when you set the RemindUnit parameter to PROJECT. | 1234 |
BizProcessIds | string | No | The ID of the workflow to which the custom alert rule is applied. A maximum of 5 workflows can be specified for a custom alert rule. You can specify multiple IDs. Separate multiple IDs with commas (,). This parameter takes effect when you set the RemindUnit parameter to BIZPROCESS. | 1,2,3 |
RemindType | string | No | The condition that triggers the alert rule. Valid values:
For more information, see Manage custom alert rules. | FINISHED |
MaxAlertTimes | integer | No | The maximum number of alerts. Valid values: 1 to 10. Default value: 3. | 3 |
AlertInterval | integer | No | The intervals at which alert notifications are sent. Unit: seconds. Minimum value: 1200. Default value: 1800. | 1800 |
Detail | string | No | The details of the conditions that trigger an alert.
| {"hour":23,"minu":59} |
AlertUnit | string | No | The recipient to whom alert notifications are sent. Valid values: OWNER and OTHER. The value OWNER indicates that alert notifications are sent to the object owner. The value OTHER indicates that alert notifications are sent to a specified user. | OWNER |
AlertMethods | string | No | The notification method. Valid values:
Multiple notification methods are separated by commas (,). | SMS,MAIL |
AlertTargets | string | No | The value format required by this parameter varies based on the value that you specify for the AlertUnit parameter. Take note of the following items:
| 9527952795279527 |
UseFlag | boolean | No | Specifies whether to enable the alert rule. Valid values:
| true |
RobotUrls | string | No | The webhook URL of the DingTalk chatbot. You can specify multiple webhook URLs. Separate multiple webhook URLs with commas (,). If this parameter is set to undefined, the specified webhook URLs are cleared. | https://oapi.dingtalk.com/robot/send?access_token=****************************** |
Webhooks | string | No | The webhook URL of the WeCom or Lark chatbot. You can specify multiple webhook URLs. Separate multiple webhook URLs with commas (,). The value of AlertMethods must include WEBHOOKS. If this parameter is set to undefined, the specified webhook URLs are cleared. Only DataWorks Enterprise Edition supports this parameter. The webhook URL-based alerting feature is supported in the following regions: China (Shanghai), China (Chengdu), China (Zhangjiakou), China (Beijing), China (Hangzhou), China (Shenzhen), China (Hong Kong), Germany (Frankfurt), and Singapore. | https://open.feishu.cn/open-apis/bot/v2/hook/******* |
Response parameters
Examples
Sample success responses
JSON
format
{
"HttpStatusCode": 200,
"Data": true,
"ErrorMessage": "The specified parameters are invalid.",
"RequestId": "0000-ABCD-EFG****",
"Success": true,
"ErrorCode": "1031203110005"
}
Error codes
HTTP status code | Error code | Error message | Description |
---|---|---|---|
429 | Throttling.Api | The request for this resource has exceeded your available limit. | - |
429 | Throttling.Api.Risk | The request for this resource has exceeded your daily available limit. | - |
429 | Throttling.Resource | You have reached the limit for the resource. Please contact us by submitting a ticket. | - |
429 | Throttling.System | The DataWorks system is busy. Try again later. | - |
429 | Throttling.User | Your request is too frequent. Try again later. | - |
500 | Forbidden.Not.Server | The dataworksAPI service is not available in this area. Please try it in another area. | - |
500 | Forbidden.Wkbench.BaselineNoPermission | You are not authorized to access the baseline. | You are not authorized to access the baseline. |
500 | Forbidden.Wkbench.ProjectNoPermission | You are not authorized to access the workspace. | You are not authorized to access the workspace. |
500 | InternalError.System | An internal system error occurred. Try again later. | - |
500 | InternalError.UserId.Missing | An internal system error occurred. Try again later. | - |
500 | Forbidden.Wkbench.RemindNoPermission | You are not authorized to modify the reminder. | You are not authorized to modify the reminder. |
500 | Invalid.Wkbench.RemindNotExist | The reminder does not exist. | The reminder does not exist. |
For a list of error codes, visit the Service error codes.
Change history
Change time | Summary of changes | Operation |
---|---|---|
2023-10-20 | The Error code has changed | View Change Details |