Устранение неполадок, связанных с выполнением кодов ошибок задания Mover хранилища

Агент mover служба хранилища Azure использует строковые коды состояния для состояний, передаваемых конечному пользователю. Все коды состояния имеют префикс AZSM , за которым следует четыре десятичные цифры. Первая десятичная цифра указывает высокий уровень состояния. Каждый код состояния должен принадлежать одной из следующих областей:

• Состояние, применимое ко всему агенту.
  Эти коды используют цифру 0области и поэтому имеют префикс AZSM0.
• Состояние, применимое к определенному заданию, выполняемого агентом.
  Эти коды используют цифру 1 области и поэтому имеют префикс AZSM1.
• Состояние, которое может быть задано агентом в определенном файле или каталоге, который передается заданием, выполняемым агентом.
  Эти коды используют цифру 2 области и поэтому имеют префикс AZSM2.

Каждая из этих областей дополнительно делит состояния на категории и подкатегории. Каждая подкатегория обычно резервирует 20 кодов состояния для дальнейшего расширения.

Совет

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

Код ошибки	Сообщение об ошибке	Сведения, устранение неполадок и устранение неполадок
AZSM1001	Не удалось подключить исходный путь	Проверьте допустимое имя сервера или IP-адрес или исходный адрес. При использовании SMB проверьте правильное имя пользователя и пароль.
AZSM1002	Произошла ошибка при сканировании источника	Повторите попытку или создайте запрос в службу поддержки.
AZSM1003	Не удалось получить доступ к исходной папке из-за проблем с разрешениями	Убедитесь, что агенту предоставлены разрешения на исходный файловый ресурс.
AZSM1004	Предоставленный исходный путь недопустим	Создайте конечную точку с допустимым путем к исходному ресурсу и обновите определение задания и повторите попытку.
AZSM1020	Другие ошибки при доступе к источнику	Эта ошибка сообщается по любой причине, что приводит к сбоям чтения исходного файла или папки. Некоторые ошибки могут быть "нет такого файла или каталога", "отклонено разрешение", "ошибка ввода и вывода" и т. д. Убедитесь, что сетевое подключение между агентом и исходным ресурсом работает хорошо. Исходный общий ресурс или папка/файлы должен присутствовать, а агент должен иметь доступ на чтение к исходной общей папке.
AZSM1021	Не удалось получить доступ к целевой папке из-за проблем с разрешениями	Повторите попытку или создайте запрос в службу поддержки.
AZSM1022	Предоставленный целевой путь недопустим	Создайте новую конечную точку с допустимым целевым контейнером и путем и обновите определение задания и повторите попытку.
AZSM1023	Срок аренды для этого агента в целевом контейнере	Повторите попытку или создайте запрос в службу поддержки.
AZSM1024	Сбой авторизации, доступ к целевому расположению	Агент не имеет достаточного разрешения для доступа к целевому расположению. Назначения ролей RBAC (управление доступом на основе ролей) выполняются автоматически при создании ресурсов с помощью портал Azure. Если вы используете API, командлеты PowerShell или пакеты SDK, вручную создайте назначение ролей для управляемого удостоверения агента для доступа к целевому расположению. Для целевого объекта контейнера BLOB-объектов хранилища используйте назначение роли участника данных BLOB-объектов хранилища . Для выбранного в качестве целевого объектом файлового ресурса Azure используйте роль Привилегированный участник данных файлов хранилища. Например, чтобы назначить роль RBAC, обратитесь к статье Назначение роли Azure для доступа к данным BLOB-объектов.
AZSM1025	Сбой проверки подлинности при доступе к исходному расположению	Убедитесь, что агент имеет права доступа к исходному расположению.
AZSM1026	Тип целевого объекта не поддерживается агентом	Этот целевой тип не поддерживается текущим агентом Перемещения хранилища.
AZSM1027	Целевое расположение занято	Агент не может претендовать на целевой ресурс или контейнер, так как существует активный лизинг. Аренда может быть из-за другого задания миграции или предыдущего прерванного задания, которое по-прежнему удерживает захват файла "AZURE_STORAGE_MOVER_MARKER". Убедитесь, что для этого целевого объекта не выполняется другое задание. Если ни один из них не запущен, перезапустите агент и повторите попытку. Если проблема продолжается, обратитесь в службу поддержки.
AZSM1028	Сбой доступа к Key Vault	Эта ошибка может возникать, если управляемому удостоверению агента не хватает доступа к RBAC key Vault, если брандмауэры или сетевые списки ACL блокируют подключения к конечной точке хранилища ключей или отсутствуют секреты. Для ошибки "Ответ 403" проверьте назначения ролей и любые правила брандмауэра на хранилище ключей, которые могут ограничивать трафик. Для других ошибок используйте параметр меню xdmsh "5) Проверить подключение к одной конечной точке" в разделе "2) Конфигурация сети", чтобы проверить доступность конечной точки.
AZSM1029	Тип исходной конечной точки не поддерживается этой версией агента	Этот тип источника не поддерживается текущим агентом Перемещения хранилища.
AZSM1030	Не удается проверить тип учетной записи хранения	Убедитесь, что учетная запись хранения и контейнер существуют, а агент был предоставлен им разрешения.
AZSM1031	Не удалось разрешить целевой узел	Проверьте конфигурацию сети, чтобы убедиться, что брандмауэры или списки контроля доступа (ACL) не блокируют доступ к конечной точке учетной записи хранения. Используйте параметр меню xdmsh "5) Проверить подключение к одной конечной точке" в разделе "2) Конфигурация сети" для проверки доступности конечной точки.
AZSM1040	Другие ошибки при доступе к целевому объекту	Скорее всего, эта ошибка является временной. Повторите задание миграции. Если проблема сохранится, создайте запрос в службу поддержки для получения дополнительной помощи.
AZSM1041	Не удалось отправить ход выполнения задания	Скорее всего, эта ошибка является временной. Повторите задание миграции. Если проблема сохранится, создайте запрос в службу поддержки для получения дополнительной помощи.
AZSM1042	Не удалось создать задание	Эта ошибка может возникать из-за различных причин, таких как не удается получить доступ к конечной точке учетной записи хранения, брандмауэрам или сетевым спискам управления доступом, блокирующим подключение, трафик от агента, который направляется через общедоступный IP-адрес, когда частная конечная точка настроена в учетной записи хранения или прокси-сервер, изменяющий сертификат. Чтобы проверить доступность конечной точки учетной записи хранения, используйте параметр меню xdmsh "5) Проверить подключение к одной конечной точке" в разделе "2) Конфигурация сети". Если сообщается об ошибке "x509: сертификат, подписанный неизвестным центром", он указывает, что локальная сеть перехватывает и изменяет SSL-сертификаты (перехват SSL) для трафика к необходимым конечным точкам, что приводит к тому, что агент не распознает полученные сертификаты. При добавлении сертификатов в агенте обычно устраняется эта проблема; однако в настоящее время эта функция не поддерживается. Чтобы разрешить агенту доступ к этим конечным точкам, рекомендуется добавить их в список разрешений для обхода перехвата SSL.
AZSM1043	Не удалось возобновить задание	Повторите попытку или создайте запрос в службу поддержки.
AZSM1044	Не удалось завершить задание.	Повторите попытку или создайте запрос в службу поддержки.
AZSM1045	Задание было прервано, пока он все еще работает.	Повторите попытку или создайте запрос в службу поддержки.
AZSM1060	Любая ошибка во время выполнения задания.	Эта ошибка может возникать из-за различных причин. Просмотрите сообщаемую ошибку и выполните действия по исправлению на основе его сведений, как описано ниже. Если ошибка указывает: 1) "InvalidResourceName": проверьте, что имена папок и файлов соответствуют поддерживаемым соглашениям об именовании. Например, "con" не является допустимым именем каталога. 2) "Указанный ресурс переполнен": проверьте использование целевого ресурса. 3) "Недопустимый дескриптор файла": убедитесь, что сетевое подключение SMB между агентом и источником работает правильно, и что сервер SMB реагирует на чтение запросов. 4) "403 Этот запрос не авторизован для выполнения этой операции": если для целевой учетной записи хранения настроена частная конечная точка, проверьте правильность настройки DNS и убедитесь, что нет ошибок маршрутизации DNS или конфигураций балансировщика нагрузки, вызывающих неправильное разрешение IP-адресов. 5) Для других ошибок повторите задание; Если проблема продолжается, создайте запрос в службу поддержки.
AZSM2021	Тип файла, не поддерживаемый целевым объектом.	Этот целевой тип не поддерживает файлы этого типа. Справочные целевые показатели масштабируемости и производительности для Файлы Azure и Хранилище BLOB-объектов Azure для получения дополнительных сведений.
AZSM2024	Длина исходного пути длиннее, чем максимальная, поддерживаемая целевым объектом.	Ознакомьтесь с рекомендациями в статье об именовании и ссылках на общие папки, каталоги, файлы и метаданные .
AZSM2026	Исходный файл имеет размер, превышающий максимальный размер, поддерживаемый целевым объектом.	Ознакомьтесь с рекомендациями в статье об именовании и ссылках на общие папки, каталоги, файлы и метаданные .
AZSM2027	Дескриптор безопасности исходного файла имеет неподдерживаемые свойства	Просмотрите разрешения файла или папки.
AZSM2061	Неизвестная ошибка, обнаруженная при сканировании источника.	Может быть временной ошибкой. Повторно выполните задание миграции.
AZSM2062	Не удалось прочитать исходный файл из-за проблем с разрешениями.	Убедитесь, что агент имеет права доступа к исходному расположению.
AZSM2063	Обнаружена ошибка ввода-вывода при чтении исходного файла.	Скорее всего, эта ошибка является временной. Повторите задание миграции. Если проблема сохранится, создайте запрос в службу поддержки для получения дополнительной помощи.
AZSM2069	Не удалось прочитать целевой файл из-за проблем с разрешениями.	Убедитесь, что агент был предоставлен разрешения целевому расположению.
AZSM2070	Не удается записать большой двоичный объект, так как у него есть активная аренда	Эта ошибка может быть вызвана записью другого агента в расположение. Убедитесь, что другое задание не выполняется в целевом объекте. Повторите попытку или создайте запрос в службу поддержки.
AZSM2071	Исходный файл был изменен во время передачи	Скорее всего, эта ошибка является временной. Повторите задание миграции. Если проблема сохранится, создайте запрос в службу поддержки для получения дополнительной помощи.
AZSM2080	Сбой копирования из-за неизвестной ошибки	Скорее всего, эта ошибка является временной. Повторите задание миграции. Если проблема сохранится, создайте запрос в службу поддержки для получения дополнительной помощи.

Устранение проблем с RBAC в Storage Mover

Во время выполнения задания выполняются автоматические назначения RBAC. Если в назначениях возникают неисправности, добавьте требуемое назначение роли вручную.

1. Перейдите к соответствующему ресурсу — Key Vault, общей папке или контейнеру BLOB-объектов.
2. Перейдите в раздел "Контроль доступа" (IAM).
3. Добавьте новое назначение роли: Назначение ролей Azure с помощью портала Azure — Azure RBAC | Microsoft Learn.
4. В мастере добавления назначения ролей найдите соответствующую роль в таблице ниже для типа ресурса, выбранного на шаге 1. В приведенном ниже примере ресурс будет Key Vault.

Тип ресурса	Необходимые роли
Key Vault	Пользователь секретов Хранилища ключей
Общий доступ к файлам	Участник с привилегированным доступом к файловым данным хранилища
Контейнер BLOB-объектов	Участник с расширенными привилегиями для данных BLOB-объектов хранилища

и. Назначение доступа должно быть установлено для управляемой идентичности.
ii. На правой панели выберите тип управляемого удостоверения Машина — Azure Arc.
iii. Выберите машинную дугу из списка. Это то же имя, что и агент.
iv. Завершите задание.