Действия и результаты.
Работа с версионируемыми инструментами.
Изучите инструмент
Сверьте название, входную схему и назначение. Публичный каталог показывает только справочные сведения, а разрешённые действия определяет аккаунт.
Выполните задачу
Перед изменением данных проверьте рабочее пространство, аккаунт и аргументы. Не рассчитывайте на дополнительное подтверждение, если клиент его не предусматривает.
Проверьте результат
Операция имеет состояние и результат. Сравните результат с исходным сервисом; при повторе учитывайте идемпотентность выбранного действия.
От принятого запроса к завершению
У выполнения есть состояния requested, queued, running, retrying, succeeded, failed, rejected и cancelled; точный enum текущего контракта смотрите в схеме Execution. Проверяйте отказ admission отдельно от сбоя провайдера. Ответ с результатом может содержать короткоживущую подписанную ссылку для большого payload.
Перед повтором изменения проверьте исход предыдущего вызова. Сеть может оборваться после применения записи у поставщика. Для поддерживающих это HTTP-методов используйте один idempotency key на одну логическую операцию; raw proxy и mirror требуют отдельной осторожности, поскольку повтор создаёт новый upstream-вызов.
Справочник выполнений описывает status, result, attempts и отмену. Отмена операции не обещает откат уже выполненного изменения во внешнем сервисе.