Job completion notification
Job completion notification¶
Notify humans or systems about completed jobs automatically. Such notifications can be sent as an Email or HTTP POST request.
E-mail notifications¶
To receive an e-mail on Job completion, set notify parameter to:
"notify": "mailto:<email_address>"
For example:
{
"tasks": [...],
"notify": "mailto:user@example.com"
}
That Email will contain the Job completion status, JobID and Job URL and will be sent to user@example.com.
Custom E-mail notifications¶
Customizable Notification Emails can be sent to multiple recipients, by using the utils:notify_email tool
That Email will contain the Job completion status, JobID and Job URL and will be sent to user@example.com.
HTTP POST request notification¶
By specifying a valid HTTP(S) URL, you can receive a POST request containing following JSON string:
{
"job_id": "<job_id>",
"job_url": "<job_url>",
"status": "<status>"
}
For example:
{
"tasks": [...],
"notify": "https://example.com/api/job_callback"
}
HTTP POST with Digest Authentication request notification¶
By specifying a valid HTTPS URL prefixed with the word “digest:”, you can receive a POST request containing following JSON string:
{
"job_id": "<job_id>",
"job_url": "<job_url>",
"status": "<status>"
}
For example:
{
"tasks": [...],
"notify": "digest:https://user:password@example.com/api/job_callback"
}