AzCopy transfer failed: журналы и безопасное возобновление

Если появилась ошибка AzCopy transfer failed, сначала сохраните ID задания, файлы плана и журналы. Найдите первую неудачную передачу, отделите аутентификацию и доступ к хранилищу от сетевых тайм-аутов и возобновляйте только работу с проверенными назначениями и оставшимися операциями.

Ключевые выводы:

• Сохраните планы и исходные файлы: новый запуск не равен возобновлению.
• Для 403 проверяйте credentials и политику, а не повторяйте смену маршрута.
• Учитывайте failed и skipped вместе с итоговым статусом.
• После фактической передачи проверьте объекты; SAS остаётся приватным.

Шаг 1: Где возникла ошибка AzCopy transfer failed?

Определите компьютер или сервис, где выполняется AzCopy, его версию, операционную систему, ID задания и роли источника и назначения. Запишите, была ли это загрузка с локального диска, скачивание или копирование между сервисами. Команда с ноутбука может инициировать облачную работу, трафик которой локальный VPN не переносит.

Храните исходную команду приватно, защищая секреты. Перед отправкой удалите значения SAS, чувствительные идентификаторы аккаунта, приватные пути и данные авторизации. Сохраните исходные файлы и состояние назначения; не удаляйте частичный результат до понимания задания.

AzCopy создаёт журналы и планы, а официальная инструкция описывает просмотр и возобновление по ID.［1］ Журнал содержит события, план — работу, обнаруженную при создании задания. Потеря плана может лишить вас основы для предусмотренного возобновления, даже если исходные файлы доступны.

Если проблема затрагивает разные клиенты, начните с базовой диагностики устройства и приложений. Для другого инструмента разберите повторы rclone отдельно: его параметры и предположения не заменяют поведение AzCopy.

Шаг 2: Что показывают журнал и счётчики передач?

Начните с уже существующего журнала, не повторяя полную передачу ради получения новой диагностики. Найдите первую существенную ошибку конкретной неудачной операции, её время и метод. Руководство Microsoft различает соединение, аутентификацию и ошибки хранилища; итоговая сводка не всегда раскрывает первопричину.［2］

Заменив заполнитель сохранённым ID, выполните команды локально:

azcopy --version
azcopy jobs list
azcopy jobs show YOUR-JOB-ID
azcopy jobs show YOUR-JOB-ID --with-status=Failed

В документированном интерфейсе значение --with-status чувствительно к регистру.［1］ Неверный фильтр или ID может скрыть именно ту работу, которую вы хотели исследовать. Сохраняйте сводку вместе с отфильтрованными ошибками; пустой вывод одной команды не доказывает отсутствие неудачных передач.

Запишите общее число, completed, failed и skipped, фактические байты и проверенное назначение. Завершённое задание может отличаться от вашего намерения, если команда исключила файлы или пропустила существующие объекты. Статус описывает это задание, а не подтверждает весь требуемый набор данных.

Шаг 3: Это отказ доступа или сетевой тайм-аут AzCopy?

Читайте ошибку с учётом аккаунта, эндпоинта, операции и времени. У 403 возможны разные причины авторизации или политики хранения; не считайте любой такой ответ истёкшим SAS и не принимайте его за разрешение использовать другой публичный исходящий адрес.

Свидетельство	Ответственная ветвь	Безопасная проверка
403 или отказ аутентификации	Credentials, разрешения, политика	Область токена, срок, условия доступа
Тайм-аут соединения или чтения	Маршрут, прокси, эндпоинт, сервис	Операция, время, устройство выполнения
Ограничение запросов или ошибка сервиса	Хранилище и повторы	Указания провайдера и сведения об инциденте
Источник не читается	Локальный путь или доступ	Сохранённый файл и права
Передача пропущена	Существующий объект или выбор файлов	Намерение операции и назначение
Требуется private endpoint	Сеть организации	Одобренное подключение и владелец DNS

Проверьте период действия credentials и нужное разрешение через обычную защищённую процедуру. Не вставляйте полный SAS в онлайн-декодер, форум поддержки или снимок экрана. Даже токен, который скоро истекает, должен оставаться приватным и не попадать в публичную диагностику.

Для storage firewall или IP-ограничения администратор подтверждает разрешённый маршрут. VPN может дать публичный адрес, который явно запрещён. Сохраните TLS: ошибка сертификата требует проверки доверия или перехвата, а не отключения защиты ради успешной сводки.

Шаг 4: Можно ли безопасно возобновить это задание?

Перед тем как начать возобновление задания AzCopy, проверьте, что источник по-прежнему содержит нужные данные, а назначение остаётся утверждённым тестовым местом. Убедитесь, что файл плана доступен в настроенном расположении. Не перемещайте и не очищайте планы как первый шаг диагностики.

Возобновление использует план и пытается передать работу, ещё не завершённую ранее. SAS не сохраняется в плане по соображениям безопасности; SAS-заданию может потребоваться повторная безопасная передача действующего токена для нужной стороны.［1］ Это обновление credentials в прежней разрешённой области, не расширение аккаунта или назначения.

azcopy jobs resume YOUR-JOB-ID

Эта базовая форма достаточна лишь тогда, когда требования аутентификации исходного задания уже выполнены. Если требуется SAS, следуйте официальной инструкции и приватно передайте токен только нужного источника или назначения. Не помещайте реальные токены в примеры и не утверждайте, что любая загрузка требует оба SAS.

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

Шаг 5: Как изолировать сравнение маршрутов?

Возьмите безвредный локальный файл и разрешённое неиспользованное назначение в тестовом контейнере. До запуска проверьте обе стороны операции. При сравнении сохраняйте версию AzCopy, область credentials, файл, параметры и эндпоинт: иначе нельзя выделить влияние одного маршрута.

Если тестовое задание можно возобновить, сохраните его ID и план для второй попытки. Не запускайте новую рекурсивную копию в рабочее место из-за тайм-аута первой. Ограниченное восстановление даёт понятные свидетельства, в отличие от перекрывающейся задачи с неопределёнными результатами записи.

Проверьте, какие настройки процесс получает из shell или планировщика. В Windows уточните контекст системного прокси, затем одобренную сетевую конфигурацию самого процесса. Браузер с другим соединением не представляет путь этой команды и не доказывает доступность передачи.

Перед сменой маршрута запишите счётчики и состояние назначения. Во второй попытке может оставаться меньше работы, потому что часть объектов уже отправлена. Назовите результат свидетельством восстановления, а не честным сравнением скорости; при отсутствии оставшейся передачи успешный resume не проверяет upload на новом пути.

Шаг 6: Передаётся ли остаток через другой разрешённый путь?

Продолжайте только для ветви соединения или тайм-аута и с разрешением менять публичный маршрут. Private endpoint, обязательный прокси и IP-политика остаются в ведении владельца. Если причиной кажется включённый VPN, сначала сравните разрешённое прямое подключение, не навязывая другой сервис.

AethoVPN может дать исходящий путь на Windows-компьютере с восстанавливаемым тестовым заданием: используйте официальный установщик и настольный Pro или Premium, выберите доступное близкое расположение и включите глобальный режим до resume. Не меняйте план и область ресурса, затем проверьте оставшиеся передачи и конечные объекты; 403, истёкший SAS, правило storage firewall и private endpoint требуют отдельного исправления. Зарегистрируйтесь по email для бесплатного 3-дневного пробного Pro и проверки восстановления задания; пробный период выдаётся один раз на пользователя и начинается при регистрации.

Для Debian/Ubuntu x64 официальный .deb устанавливается на фактическую машину AzCopy. Mac использует руководство сайта и VPN-клиент с Pro или Premium. Не описывайте нативное приложение Mac и не утверждайте, что локальный клиент меняет маршрут облачного worker.

До resume проверьте VPN-соединение. Запишите обе попытки и остановитесь при неразрешённом пути или повторном отказе доступа. Одно восстановление не гарантирует последующую доступность и не меняет обязанности владельца хранилища.

Шаг 7: Проверено ли назначение и завершён ли тест?

Снова откройте статистику и оставшиеся failed. Явно объясните skipped: объекты уже правильные, исключены командой или фактически не передавались? Даже нулевой failed нужно сопоставить с требуемым тестовым объектом, ожидаемым размером и содержимым.

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

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

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

Итоги

• Сохраните ID, планы, журналы и исходные данные.
• Определите первую ошибку до смены credentials или маршрута.
• Возобновляйте только проверенную работу, записывая фактическую передачу.
• Сверяйте содержимое назначения со всеми счётчиками задания.

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

Чем новая копия отличается от возобновления?

Resume использует исходный план и оставшуюся работу. Новый запуск обнаруживает новую задачу и может затронуть существующие назначения, поэтому сначала проверьте область записи, не считая команды эквивалентными.［1］

Любой 403 означает истёкший SAS?

Ответ может отражать права или политику хранилища наряду с условиями credentials. Проверяйте операцию и разрешённую область; не обновляйте токены и маршруты без определения ответственной ветви.

Можно возобновить после удаления планов?

Документированное восстановление опирается на план задания. Сохраните его до очистки; при отсутствии владелец должен определить новое разрешённое восстановление вместо догадок о файлах, которые ещё надо отправить.

Почему resume завершается без отправленных байтов?

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

Нужно ли отправлять SAS поддержке?

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

Поможет локальный VPN частному эндпоинту?

Private endpoint требует одобренной сети и настройки имён организации. Другой публичный адрес не создаёт частное соединение и может нарушить storage firewall или правила исходящего IP.

Когда можно вновь запускать рабочее задание?

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

Отказ от ответственности: Возобновляйте только разрешённые задания, сохраняя исходные данные. Не обходите ограничения хранилища, не раскрывайте credentials и не отключайте проверку сертификатов ради успешной сводки.

Источники

1. Microsoft — Find errors and resume jobs with logs in AzCopy — https://learn.microsoft.com/en-us/azure/storage/common/storage-use-azcopy-configure
2. Microsoft — Troubleshoot issues in AzCopy — https://learn.microsoft.com/en-us/troubleshoot/azure/azure-storage/blobs/connectivity/storage-use-azcopy-troubleshoot

Sources checked 7 октября 2026 г.

Рекомендуемые статьи

• Как rclone отделяет повторы от ошибок хранилища
• Проверьте VPN перед повтором задания AzCopy
• Прокси Windows, который может подхватить AzCopy