Задание#
Задания предназначены для запуска вычислений в следующих режимах:
Регулярный — согласно расписанию, задаваемому при создании или редактировании Задания, в cron-формате.
Однократный - разовый запуск по времени, задаваемому при создании или редактировании Задания, в cron-формате.
Принудительный — ручной запуск, осуществляемый по запросу через API.
После запуска вычисления сервис Планировщик Заданий (Batch Scheduler) не удаляет Задание, поэтому оно может быть запущено вновь по расписанию или по запросу.
У одного Задания может быть множество экземпляров, которые не зависят друг от друга. Пользователь управляет экземплярами Заданий, используя API сервиса Batch Scheduler.
Атрибуты сущности#
Атрибут |
Описание |
|---|---|
Основные параметры |
|
name |
Уникальное пользовательское наименование Задания. |
description |
Произвольное описание Задания. |
Расписание запуска |
|
schedule |
Расписание запуска Задания в cron-формате. Если атрибут не заполнен (пустая строка |
Целевой HTTP-запрос |
|
httpTarget |
Параметры запроса HTTP. Является вложенной сущностью для Заданий. |
Состояние и мониторинг |
|
state |
Текущее состояние Задания. Автоматический запуск по расписанию выполняется, только если Задание имеет статус |
updateTime |
Дата и время последнего изменения сущности. |
lastAttempt |
Информация о последней попытке запуска Задания. Атрибут только на чтение. |
Условия запуска |
|
runMissedJob |
Параметр запуска пропущенных вызовов. Значение по умолчанию — false |
timeRunMissedJob |
Параметр определяет период, в течении которого будет осуществляться запуск пропущенных вызовов |
onlyOneInstance |
Признак запуска не более одного экземпляра задачи одновременно. Значение по умолчанию — false |
retryPolicy |
Политика повторов. Является вложенной сущностью для Заданий. |
async |
Параметр для установки асинхронного выполнения Задания. |
startNoEarlierTime |
Параметр для установки даты и времени, с которого Задание должно выполняться. |
startNoLaterTime |
Параметр для установки даты и времени, до которого Задание должно выполнится. |
oneTimeLaunch |
Параметр определяет разовый запуск Задания. |
responseTimeOut |
Параметр определяет максимальное время ожидания ответа от вызываемого веб-сервиса. |
Настройки запросов |
|
externalId |
Параметр определяет идемпотентность запроса |
Состояние Задания#
Возможны следующие значения состояния задания:
Статус |
Описание |
Допустимые операции в этом состоянии |
|---|---|---|
ENABLED |
Задание может выполняться либо по расписанию, либо по запросу |
Run, List, Get, Pause, Delete, Search, Update |
PAUSED |
Задание перестает выполняться по расписанию, но может быть запущено по запросу |
Run, List, Get, Resume, Delete, Search, Update, Resume |
DONE |
Задание перестает выполняться по расписанию. Информирует об отсутствии запланированных Запусков |
List, Get, Delete, Search, Resume |
DELETED |
Задание удалено — не выполняется ни по расписанию, ни по запросу |
Get |
Возможные изменения состояния задания#
Действия над сущностью#
Для работы с сущностью доступны следующие действия:
Создание Задания;
Получение Задания по имени;
Получение списка Заданий;
Удаление Задания по имени;
Выполнение разового запуска Задания по запросу;
Изменение Задания;
Приостановка выполнения автоматического запуска Задания;
Восстановление автоматического запуска Задания;
Поиск Заданий из списка Заданий.