Методы для работы с задачами

Задачи используются для обработки запросов, которые требуют много времени и выполняются асинхронно. С помощью состояний задачи вы можете следить за ходом выполнения действий, заданных в запросе.

Задача может находиться в одном из следующих состояний:

• Created – задача создана, но не запущена.
• Starting – задача находится в процессе запуска.
• Running – задача выполняется. Для задачи в этом состоянии указывается прогресс (progress) выполнения в процентах.
• Completed – задача успешно завершена. Для задачи в этом состоянии указывается результат выполнения (result). Результат содержит зависимые от задачи данные, например идентификатор нового клиента после выполнения задачи CreateTenant.
• Stopping – задача подготавливается к завершению. Если вы прекратили выполнение задачи, она может находиться в этом состоянии, прежде чем перейти в состояние Cancelled.
• Failed – задача завершилась с ошибкой. Для задачи в этом состоянии указывается расширенная информация об ошибке (error).
• Cancelled – выполнение задачи прекращено пользователем или системой. Для задачи в этом состоянии указывается расширенная информация об ошибке (error).
• Queued – задача поставлена в очередь и ожидает начала выполнения.

Средствами REST API Сервера интеграции вы можете выполнять следующие действия с задачами:

• получать список задач;
• получать сведения об указанной задаче;
• отменять выполнение указанной задачи.