Query custom alert rule information by using GetRemind - DataWorks - Alibaba Cloud - DataWorks

Queries the details of a custom alert rule.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request parameters

Parameter	Type	Required	Description	Example
RemindId	integer	Yes	The custom alert rule ID.	1234

Response elements

Element	Type	Description	Example
	object	The response parameters.
HttpStatusCode	integer	The HTTP status code.	200
RequestId	string	The request ID.	0000-ABCD-EFGH-IJK****
ErrorMessage	string	The error message.	The specified parameters are invalid.
ErrorCode	string	The error code.	1031203110005
Success	boolean	Indicates whether the request was successful.	true
Data	object	The details of the custom alert rule.
MaxAlertTimes	integer	The maximum number of alerts.	3
RemindUnit	string	The type of object that the custom alert rule applies to. Valid values: NODE (node), BASELINE (baseline), PROJECT (workspace), and BIZPROCESS (workflow).	NODE
AlertInterval	integer	The minimum interval at which alerts are reported. Unit: seconds.	1800
Useflag	boolean	Indicates whether the custom alert rule is enabled. Valid values: true and false.	true
Founder	string	The Alibaba Cloud account ID of the alert rule creator.	9527951795****
RemindId	integer	The custom alert rule ID.	1234
DndEnd	string	The end time of the quiet hours. The value is in the hh:mm format. Valid values of hh: [0,23]. Valid values of mm: [0,59].	08:00
RemindType	string	The conditions that trigger an alert. Valid values: FINISHED, UNFINISHED, ERROR, CYCLE_UNFINISHED, and TIMEOUT.	FINISHED
AlertUnit	string	The type of the alert recipient. For more information about alert recipient types, see the Receivers parameter. Valid values: OWNER: the task owner OTHER: specified personnel SHIFT_SCHEDULE: personnel in a shift schedule	OWNER
DndStart	string	The start time of the quiet hours. The value is in the hh:mm format. Valid values of hh: [0,23]. Valid values of mm: [0,59].	00:00
RemindName	string	The name of the rule.	Rule name
Detail	string	If the value of the RemindType parameter is FINISHED, this parameter is left empty. If the value of the RemindType parameter is UNFINISHED, the trigger conditions are returned as key-value pairs. Example: {"hour":23,"minu":59}. Valid values of hour: [0,47]. Valid values of minu: [0,59]. If the value of the RemindType parameter is ERROR, this parameter is left empty. If the value of the RemindType parameter is CYCLE_UNFINISHED, the trigger conditions are returned as key-value pairs. Example: {"1":"05:50","2":"06:50","3":"07:50","4":"08:50","5":"09:50","6":"10:50","7":"11:50","8":"12:50","9":"13:50","10":"14:50","11":"15:50","12":"16:50","13":"17:50","14":"18:50","15":"19:50","16":"20:50","17":"21:50","18":"22:50","19":"23:50","20":"24:50","21":"25:50"}. The key indicates the ID of the cycle. Valid values: [1,288]. The value indicates the timeout period of the node that is running in the cycle. Specify the value in the hh:mm format. Valid values of hh: [0,47]. Valid values of mm: [0,59]. If the value of the RemindType parameter is TIMEOUT, the timeout period is returned. Unit: seconds. Example: 1800. This value indicates that an alert is reported if the node has run for more than 30 minutes.	{"hour":23,"minu":59}
Robots	array<object>	The webhook URLs of the DingTalk chatbots.
	object
WebUrl	string	The webhook URL of the DingTalk chatbot.	https://oapi.dingtalk.com/robot/send?access_token=******************************
AtAll	boolean	Indicates whether all members in the DingTalk group are notified. Valid values: true and false.	true
Nodes	array<object>	The nodes to which the custom alert rule is applied. This parameter is returned if the value of the RemindUnit parameter is NODE.
	object
Owner	string	The Alibaba Cloud account ID of the node owner.	9527951795****
NodeName	string	The name of the node.	Node name
NodeId	integer	The node ID.	1234
ProjectId	integer	The ID of the workspace to which the node belongs.	1234
Baselines	array<object>	The baselines to which the custom alert rule is applied. This parameter is returned if the value of the RemindUnit parameter is BASELINE.
	object
BaselineName	string	The name of the baseline.	Baseline name
BaselineId	integer	The baseline ID.	1234
Projects	array<object>	The workspaces to which the custom alert rule is applied. This parameter is returned if the value of the RemindUnit parameter is PROJECT.
	object
ProjectId	integer	The workspace ID.	1234
BizProcesses	array<object>	The workflows to which the custom alert rule is applied. This parameter is returned if the value of the RemindUnit parameter is BIZPROCESS.
	object
BizProcessName	string	The name of the workflow.	Business process name
BizId	integer	The ID of the workflow.	9527
AlertTargets	array	The alert recipients. For details, see the Receivers parameter.
	string	If the value of the AlertUnit parameter is OWNER, this parameter is left empty. If the value of the AlertUnit parameter is OTHER, the ID of the Alibaba Cloud account used by the specified user is returned. If the value of the AlertUnit parameter is SHIFT_SCHEDULE, the shift schedule ID is returned.	9527952795279527
AlertMethods	array	The notification method.
	string	The notification method. Valid values: MAIL SMS Alert notifications can be sent by text message only in the Singapore, Malaysia (Kuala Lumpur), and Germany (Frankfurt) regions.	SMS,MAIL
Webhooks	array	The webhook URLs.
	string	The webhook URL of a WeCom or Lark chatbot. Webhooks must be specified for AlertMethods. Supported only in DataWorks Enterprise Edition.	https://open.feishu.cn/open-apis/bot/v2/hook/*******
Receivers	array<object>	The information about the alert recipients.
	object	The information about the alert recipient.
AlertUnit	string	The type of the alert recipient. For more information about alert recipients, see the Receivers parameter. Valid values: OWNER: the task owner. OTHER: specified personnel. SHIFT_SCHEDULE: personnel in a shift schedule.	OWNER
AlertTargets	array	The alert recipient.
	string	If the value of the AlertUnit parameter is OWNER, this parameter is left empty. If the value of the AlertUnit parameter is OTHER, the ID of the Alibaba Cloud account used by the specified user is returned. If the value of the AlertUnit parameter is SHIFT_SCHEDULE, the shift schedule ID is returned.	9527952795279527
AllowNodes	array	The IDs of nodes added to a whitelist.
	integer	The ID of a node added to a whitelist. Nodes in the whitelist are excluded from monitoring.	123

Examples

Success response

JSON format

{
  "HttpStatusCode": 200,
  "RequestId": "0000-ABCD-EFGH-IJK****",
  "ErrorMessage": "The specified parameters are invalid.",
  "ErrorCode": "1031203110005",
  "Success": true,
  "Data": {
    "MaxAlertTimes": 3,
    "RemindUnit": "NODE",
    "AlertInterval": 1800,
    "Useflag": true,
    "Founder": "9527951795****",
    "RemindId": 1234,
    "DndEnd": "08:00",
    "RemindType": "FINISHED",
    "AlertUnit": "OWNER",
    "DndStart": "00:00",
    "RemindName": "Rule name",
    "Detail": "{\"hour\":23,\"minu\":59}",
    "Robots": [
      {
        "WebUrl": "https://oapi.dingtalk.com/robot/send?access_token=******************************",
        "AtAll": true
      }
    ],
    "Nodes": [
      {
        "Owner": "9527951795****",
        "NodeName": "Node name",
        "NodeId": 1234,
        "ProjectId": 1234
      }
    ],
    "Baselines": [
      {
        "BaselineName": "Baseline name",
        "BaselineId": 1234
      }
    ],
    "Projects": [
      {
        "ProjectId": 1234
      }
    ],
    "BizProcesses": [
      {
        "BizProcessName": "Business process name",
        "BizId": 9527
      }
    ],
    "AlertTargets": [
      "9527952795279527"
    ],
    "AlertMethods": [
      "SMS,MAIL"
    ],
    "Webhooks": [
      "https://open.feishu.cn/open-apis/bot/v2/hook/*******"
    ],
    "Receivers": [
      {
        "AlertUnit": "OWNER",
        "AlertTargets": [
          "9527952795279527"
        ]
      }
    ],
    "AllowNodes": [
      123
    ]
  }
}

Error codes

HTTP status code	Error code	Error message	Description
500	Forbidden.Not.Server	The dataworksAPI service is not available in this area. Please try it in another area.
500	InternalError.System	An internal system error occurred. Try again later.
500	InternalError.UserId.Missing	An internal system error occurred. Try again later.
403	Forbidden.Access	Access is forbidden. Please first activate DataWorks Enterprise Edition or Flagship Edition.	No permission, please authorize
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.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.