Справочник кодов ошибок Power Automate: основные ошибки HTTP и коннекторов

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

Этот справочник содержит основные коды состояния HTTP и типичные внутренние имена ошибок Power Automate, задокументированные в официальном справочнике кодов ошибок для облачных потоков Microsoft. По каждой ошибке кратко объясняется, что она означает, какие причины встречаются чаще всего и куда смотреть в первую очередь. Просто найди код, который сейчас отображается в твоём журнале выполнения.

Обзор кодов состояния HTTP

Многие ошибки коннекторов в Power Automate на самом деле представляют собой классические коды состояния HTTP, которые возвращает вызываемый API. Microsoft перечисляет самые распространённые из них в документации по целостности коннекторов:

• 400 Bad Request: сервер не может или не хочет обработать запрос, потому что входные данные некорректны.
• 401 Unauthorized: не удалась аутентификация, отсутствуют действительные учётные данные.
• 403 Forbidden: превышен лимит запросов API или отсутствует разрешение.
• 404 Not Found: вызванная операция больше не существует или помечена как устаревшая.
• 409 Conflict: запрос конфликтует с текущим состоянием целевого ресурса, часто решается повторной отправкой после исправления.
• 415 Unsupported Media Type: тип содержимого запроса не поддерживается сервером.
• 429 Too Many Requests: достигнут лимит запросов API.
• 500 Internal Server Error: непредвиденная ошибка на стороне сервера.
• 502 Bad Gateway: проблема на веб-сервере хостинга, часто закрытое соединение.
• 504 Gateway Timeout: сервер не отвечает вовремя.
• 522, 523, 524: ошибки соединения или превышения времени ожидания, обычно вызванные недоступностью или перегрузкой целевой службы.

Важно знать: ошибки из диапазона 400 практически всегда связаны с самим запросом, тогда как ошибки из диапазона 500 указывают на проблему на стороне вызываемой службы и обычно устраняются только ожиданием или повторной попыткой.

Ошибки подключения и аутентификации

Эта группа ошибок возникает, когда поток больше не может войти в подключённую службу.

• InvalidConnection: ссылка на подключение указывает на подключение, которое было удалено, истекло или прервано. Открой поток, выбери затронутое действие и заново создай подключение.
• ConnectionNotConfigured: для действия требуется подключение, но оно не выбрано, часто после импорта из решения. Выбери подходящее подключение в действии.
• ConnectionAuthorizationFailed: подключение существует, но сохранённые учётные данные больше не действительны, например потому что был изменён пароль или истёк токен OAuth после 90 дней бездействия. Перейди в Подключения, выбери затронутое подключение и используй Исправить подключение.
• Unauthorized (401): токен аутентификации недействителен или истёк. Дополнительно проверь журналы входа в Microsoft Entra ID на предмет блокировок условным доступом.
• Forbidden (403): пользователю или приложению не разрешено выполнять эту операцию. Наиболее частая причина — политика DLP, блокирующая коннектор в среде, или отсутствие разрешений на целевом ресурсе.

Согласно документации Microsoft, для рабочих (production) потоков стоит перейти на подключение через субъект-службу (service principal), поскольку оно не истекает при смене пароля сотрудником или его уходе из компании.

Ошибки коннектора и API

Эти ошибки исходят от самой вызываемой службы, а не от Power Automate.

• ActionFailed: общее сообщение об ошибке, означающее, что действие завершилось неудачно. Настоящая причина указана в тексте вывода действия — открой неудачное выполнение и разверни Выходные данные.
• BadRequest (400): входные данные имеют неверный формат, например строка там, где ожидается число, или в теле запроса отсутствует обязательное поле.
• NotFound (404): указанный ресурс, например список SharePoint или папка почтового ящика, был переименован, перемещён или удалён.

Во всех трёх случаях помогает один и тот же первый шаг: открыть неудачное выполнение в журнале выполнения и сравнить входные данные с фактически ожидаемым форматом.

Ошибки времени разработки и выражений

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

• InvalidTemplate: синтаксическая ошибка в выражении, часто несовпадающие скобки или неверное имя действия.
• FlowCheckerError: проверка потока обнаружила проблему с проверкой данных, обычно пустое обязательное поле или отсутствующее подключение.
• DuplicateActionName: два действия в одном потоке внутренне имеют одинаковое имя, часто после копирования и вставки без переименования.
• MissingRequiredProperty: обязательное поле в действии или триггере осталось пустым.
• ExpressionEvaluationFailed: выражение не может быть вычислено во время выполнения, поскольку фактические данные не соответствуют выражению, например обращение к полю пустого объекта. Защита с помощью `coalesce()` обычно решает эту проблему.
• ContentConversionFailed: потоку не удалось преобразовать данные из одного типа в другой, например дату в неожиданном формате.

Ошибки времени ожидания и ограничения частоты

Эта группа возникает, как только поток превышает лимиты по времени или объёму.

• ActionTimedOut: отдельное действие превысило настроенный лимит времени; таймаут по умолчанию для HTTP-действия составляет 100 секунд.
• OperationTimedOut: длительная операция, например согласование или веб-перехватчик (webhook), превысила максимальное время ожидания. Согласно документации, облачные потоки выполняются не более 30 дней.
• WorkflowRunActionRepetitionQuotaExceeded: цикл, например «Применить ко всем», превысил максимальное число итераций, часто из-за вложенных циклов без предварительной фильтрации.
• FlowRunQuotaExceeded: достигнут дневной лимит выполнения действий для пользователя или потока в зависимости от уровня лицензии.
• DirectApiAuthorizationRequired: поток использует премиум-коннектор, но у вызвавшего пользователя нет подходящей лицензии.

Как действовать системно

Вместо того чтобы гуглить каждую ошибку по отдельности, помогает фиксированный порядок действий, который также описывает Microsoft в руководстве по устранению ошибок облачных потоков:

• Открой неудачное выполнение в журнале выполнения и определи действие, отмеченное красным.
• Разверни Входные данные и Выходные данные действия, чтобы увидеть точный код состояния и сообщение об ошибке.
• Отнеси код к соответствующей категории из этого справочника: подключение, запрос, выражение или время ожидания.
• Если ты не находишь текст ошибки в этом обзоре, скопируй его дословно и поищи на форумах сообщества Power Automate, где уже обсуждались почти все особые случаи.

Если поток у вас регулярно останавливается с одними и теми же кодами ошибок, или вы не можете определить причину даже с этим справочником, мы с удовольствием разберёмся в этом вместе в рамках нашего консалтинга по Power Automate. Как цифровые сотрудники, мы один раз аккуратно настраиваем подключения, обработку ошибок и логику повторных попыток и документируем их так, чтобы контроль над своими потоками оставался у тебя.

Часто задаваемые вопросы

В чём разница между кодом состояния HTTP и ошибкой вроде ActionFailed?

Коды состояния HTTP, такие как 401 или 404, поступают напрямую от вызываемой службы и описывают, почему не удался конкретный запрос. Ошибки же вроде ActionFailed — это общая обёртка Power Automate, за которой почти всегда скрывается один из этих HTTP-кодов. Открой выходные данные неудачного действия, чтобы найти реальный код состояния за ней.

Почему я получаю ошибку 403, хотя мои учётные данные верны?

Ошибка 403 не обязательно означает неверные учётные данные — скорее, отсутствует разрешение на конкретную операцию. Наиболее частые причины — политика предотвращения потери данных, блокирующая коннектор в вашей среде, отсутствие доступа на запись к целевому ресурсу или превышенный лимит запросов API. Сначала проверь разрешения на целевом ресурсе, затем политики DLP в своей среде.

Как узнать, какое действие вызвало ошибку?

Открой затронутый поток, выбери неудачное выполнение в списке последних выполнений и найди красный значок предупреждения. Затронутое действие можно развернуть — там в разделах «Входные данные» и «Выходные данные» отображаются точный код состояния и исходное сообщение об ошибке вызываемой службы.

Стоит ли исправлять каждую ошибку самостоятельно и сразу?

При однократных HTTP-ошибках, например 429 или 502, обычно достаточно повторной попытки, поскольку причина находится на стороне внешней службы и носит временный характер. Если же одна и та же ошибка повторяется, стоит настроить в потоке структурированную обработку ошибок, например с политиками повторных попыток и определённым запасным (fallback) действием, вместо того чтобы каждый раз перезапускать поток вручную.

Существуют ли эти коды ошибок и для настольных потоков (desktop flows)?

Описанные здесь коды относятся к облачным потокам. Для настольных потоков, которые выполняются на твоём ПК, Microsoft ведёт отдельный справочник под названием «Обработка ошибок настольных потоков», поскольку там играют роль другие источники ошибок, такие как элементы пользовательского интерфейса или локальные приложения.