Ошибка 429 Too Many Requests: OneDrive, Office 365, SharePoint

Когда задание GoodSync подключается к Microsoft OneDrive, Office 365 или SharePoint, Microsoft может временно ограничить количество обрабатываемых запросов. Это называется ограничением частоты запросов или троттлингом.

Троттлингом управляет Microsoft: он защищает службы Microsoft 365 от чрезмерной активности. Обычно он не означает, что есть проблема с вашей лицензией GoodSync, паролем аккаунта или настройками задания.

Сообщение об ошибке

Может появиться ошибка, похожая на следующую:

Rate Limit, Throttled by Microsoft (retry-after:5): Server says: Too Many Requests (status code 429) [activityLimitReached] The request has been throttled

Также может появиться одна из связанных ошибок Microsoft:

  • 429 Too Many Requests: Microsoft получила больше запросов, чем допускает в данный момент.
  • 503 Service Unavailable или Server Too Busy: служба Microsoft временно перегружена, недоступна или продолжает ограничивать запросы.

Что означает эта ошибка

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

Значение retry-after возвращает Microsoft; оно показывает, сколько секунд приложение должно подождать перед следующим запросом. Например, retry-after:5 означает, что Microsoft просит подождать не менее пяти секунд перед повторной попыткой.

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

1. Дайте GoodSync больше времени на переподключение

Увеличение времени переподключения дает GoodSync больше времени на повторные попытки выполнить операцию, прежде чем задание будет признано неудавшимся.

  1. Выберите затронутое задание GoodSync.
  2. Нажмите Задание > Настройка задания.
  3. Выберите Скорость/Ограничения.
  4. Найдите параметр Общее время на попытки переподключения (сек.).
  5. Увеличьте значение выше стандартных 120 секунд. При повторяющемся троттлинге значение, например 600 секунд, даст Microsoft больше времени на снятие временного ограничения.
  6. Нажмите Сохранить, чтобы применить изменение.

Важно: Увеличение этого значения не повышает и не снимает лимит использования Microsoft. Оно позволяет GoodSync дольше продолжать попытки переподключения, прежде чем задание завершится с ошибкой.

Подробнее см. Общее время на попытки переподключения (сек.).

2. Уменьшите количество параллельных потоков

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

  1. Выберите затронутое задание GoodSync.
  2. Нажмите Задание > Настройка задания.
  3. Выберите Скорость/Ограничения.
  4. Найдите параметр Количество параллельных потоков при синхронизации.
  5. Уменьшите текущее значение. Если троттлинг продолжается, задайте для задания 1 поток или отключите этот параметр, чтобы синхронизация выполнялась последовательно.
  6. Нажмите Сохранить, чтобы применить изменение.

Примечание: При меньшем числе параллельных потоков задание может выполняться дольше, зато уменьшается количество одновременных запросов к Microsoft.

Подробнее см. Количество параллельных потоков при синхронизации.

3. Разделите большие наборы данных и разнесите расписания заданий

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

Важно: Не запускайте все эти меньшие задания одновременно. Одновременно работающие задания могут увеличить активность Microsoft API и вызвать дополнительный троттлинг.

4. Запускайте большие задания в часы наименьшей нагрузки

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

5. Сократите конкурирующую активность в Microsoft 365

Другие задания GoodSync, клиент синхронизации Microsoft OneDrive, средства миграции, приложения резервного копирования, проверки безопасности и другие службы могут расходовать лимиты того же аккаунта или тенанта Microsoft. По возможности приостановите эти процессы или перенесите их на другое время, чтобы они не пересекались с затронутым заданием GoodSync.

Что делать, пока действует троттлинг задания

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

Если ошибка повторяется

Если ошибки 429 или 503 продолжаются после описанных выше изменений:

  1. Задайте для затронутого задания один поток синхронизации.
  2. Временно остановите другие задания и приложения, обращающиеся к тому же аккаунту или тенанту Microsoft.
  3. Запустите задание снова в часы наименьшей нагрузки.
  4. Попросите администратора Microsoft 365 проверить на странице Service health и в Message center, нет ли инцидентов в службах Microsoft или уведомлений об ограничении активности приложений.
  5. Если помощь все еще нужна, откройте GoodSync и выберите Помощь > Сообщить об ошибке. Приложите журналы затронутого задания и укажите примерное время, когда возник троттлинг.

GoodSync не может снять или увеличить лимит частоты запросов, установленный Microsoft. Однако служба поддержки GoodSync может изучить настройки задания и журналы, чтобы помочь снизить частоту запросов и улучшить поведение при повторных попытках.

Дополнительная информация

Вернуться наверх