Как возобновить настройку

Найдите незавершённое задание настройки и повторите создание рекомендаций для типов со сбоем, не заменяя готовые наборы.

Сохраните id и engineId задания настройки сразу после его успешного создания. Используйте GET /v2/provisioning/jobs/:id, если клиент отключился или неясно, чем закончилось ожидание. Состояния задания и отдельных типов определяют, что нужно восстановить.

Найдите выполняющиеся задания #

http
GET /v2/organizations/:orgId/provisioning/jobs?status=running
X-API-Key: YOUR_API_KEY

status=running обязателен. Ответ содержит data — массив доступных для просмотра выполняющихся заданий без курсорной пагинации. Добавьте startedBy=me, чтобы получить только задания, запущенные аутентифицированным пользователем. Сервисный ключ не связан с пользователем, поэтому этот фильтр вернёт для него пустой список.

Если ответ на запрос создания нового движка потерялся, проверьте также GET /v2/organizations/:orgId/engines и панель управления: возможно, движок уже создан. Задание могло завершиться и исчезнуть из списка выполняющихся. Повторный запрос может создать ещё один движок.

Повторите попытку для типов со сбоем #

http
POST /v2/provisioning/jobs/:id/retry
X-API-Key: YOUR_API_KEY

У этого запроса нет тела. Он возвращает новое задание на том же движке с теми же источниками. Выбираются только типы со сбоем, которые всё ещё пусты. Готовые наборы сохраняются. Сохраните ИД нового задания и отслеживайте его до завершения.

NothingToProvision (409) означает, что не осталось типов со сбоем, для которых можно повторить попытку. Например, с тех пор другое действие могло прикрепить набор. ProvisioningJobRunning (409) указывает на задание, которое уже выполняется на этом движке. Прежде чем повторять попытку, проверьте эти ресурсы.

Если источники нужно изменить, отправьте новое задание на существующий движок с исправленными источниками, осознанно выбрав Empty или Requested. Маршрут повторной попытки использует исходные входные данные.

Разберитесь с ограничениями и незавершёнными запусками #

ProvisioningLimitReached (429) содержит retryAt. Дождитесь указанного времени, прежде чем отправлять запрос повторно. При ошибках, связанных с кредитами, планом или доступом, нужно внести соответствующие изменения в учётную запись или права доступа.

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

Когда задание завершится, проверьте созданные рекомендации в Studio, прежде чем использовать их для перевода.