排查存储移动程序作业运行错误代码问题

Azure 存储程序代理对传递给最终用户的状态使用字符串状态代码。 所有状态代码都有前缀 AZSM，后跟四个十进制数字。 第一个十进制数字指示状态的高级范围。 每个状态代码应属于以下范围之一：

• 应用于整个代理的状态。
  这些代码使用范围数字 0，因此具有前缀 AZSM0。
• 适用于代理运行的特定作业的状态。
  这些代码使用范围数字 1，因此具有前缀 AZSM1。
• 由代理运行的任务传输的特定文件或目录可能设定的状态。
  这些代码使用范围数字 2，因此具有前缀 AZSM2。

每个范围进一步将状态划分为类别和子类别。 每个子类别通常保留 20 个状态代码，以适应未来的扩展。

提示

AZSM0000 是一种特殊的不依赖于范围的状态代码，用于表示在任何范围/级别上的成功操作。

错误代码	错误消息	详细信息/故障排除步骤/缓解
AZSM1001	无法装载源路径	验证提供的服务器名称或 IP 地址是否有效，或者源位置是否正确。 如果使用 SMB，请验证提供的用户名和密码是否正确。
AZSM1002	扫描源时遇到错误	重试或创建支持票证。
AZSM1003	由于权限问题，无法访问源文件夹	验证是否已向代理授予对源文件共享的权限。
AZSM1004	提供的源路径无效	使用有效的源共享路径创建新终结点，并更新作业定义并重试。
AZSM1020	访问源时出现其他错误	无论因何种原因导致源文件/文件夹读取失败，都会报告此错误。 某些错误可能是“没有此类文件或目录”、“权限被拒绝”、“输入/输出错误”等。确保代理与源共享之间的网络连接良好。 源共享/文件夹/文件必须存在，代理应具有对源共享的读取访问权限。
AZSM1021	由于权限问题，无法访问目标文件夹	重试或创建支持票证。
AZSM1022	提供的目标路径无效	使用有效的目标容器和路径创建新终结点，并更新作业定义并重试。
AZSM1023	目标容器上此代理的租约已过期	重试或创建支持票证。
AZSM1024	访问目标位置的授权失败	代理没有足够的权限访问目标位置。 使用 Azure 门户创建资源时，会自动执行 RBAC（基于角色的访问控制）角色分配。 如果使用 API、PowerShell cmdlet 或 SDK，请手动为代理的托管标识创建角色分配以访问目标位置。 对于存储 Blob 容器目标，请使用 存储 Blob 数据参与者 角色分配。 对于作为目标的 Azure 文件共享，请使用“存储文件数据特权参与者”。 例如，若要分配 RBAC 角色，请参阅 “分配 Azure 角色以访问 Blob 数据 ”一文。
AZSM1025	访问源位置的身份验证失败	验证代理是否有权访问源位置。
AZSM1026	代理不支持目标类型	当前存储移动器代理不支持此目标类型。
AZSM1027	目标位置正忙	代理无法声明目标共享或容器，因为存在活动租约。 该租约可能是由于另一个迁移作业或之前中止的作业仍占用文件“AZURE_STORAGE_MOVER_MARKER”。 请确保没有针对此目标运行的其他作业。 如果没有任何程序正在运行，请重启代理程序，然后重试。如果问题仍然存在，请联系技术支持人员。
AZSM1028	Key Vault 访问失败	如果代理的托管标识缺少“Key Vault 机密用户”RBAC 访问、防火墙或网络 ACL 阻止与密钥保管库终结点的连接，或者缺少机密，则会发生此错误。 对于“RESPONSE 403”错误，请检查密钥保管库上可能限制流量的角色分配和任何防火墙规则。 对于其他错误，请使用 xdmsh 菜单选项“5）在”2）网络配置“下测试单终结点连接性”来验证终结点可访问性。
AZSM1029	此代理版本不支持源终结点类型	当前存储移动器代理不支持此源类型。
AZSM1030	无法验证存储帐户类型	验证存储账户和容器是否存在，以及代理是否已获得它们的权限。
AZSM1031	无法解析目标主机	检查网络配置以确认防火墙，或 ACL 不会阻止对存储帐户终结点的访问。 使用“2）网络配置”下的 xdmsh 菜单选项“5）测试单终结点连接”来验证终结点可访问性。
AZSM1040	访问目标时出现其他错误	此错误可能是暂时性的。 再次重试迁移作业。 如果问题仍然存在，请创建支持票证以获取进一步的帮助。
AZSM1041	无法发送作业进度	此错误可能是暂时性的。 再次重试迁移作业。 如果问题仍然存在，请创建支持票证以获取进一步的帮助。
AZSM1042	未能创建作业	此错误可能由于各种原因发生，比如代理无法访问存储帐户终结点、防火墙或网络 ACL 阻止连接、在存储帐户上配置专用终结点时代理流量通过公共 IP 路由，或代理修改证书。 若要验证存储帐户终结点可访问性，请使用“2）网络配置”下的 xdmsh 菜单选项“5）测试单终结点连接”。 如果报告的错误为“x509：由未知颁发机构签名的证书”，则表示本地网络正在截获和更改 SSL 证书（SSL 拦截），以便将流量发送到所需终结点，导致代理无法识别收到的证书。 将证书添加到代理通常会解决此问题，但目前不支持此功能。 若要使代理能够访问这些终结点，请考虑将其添加到允许列表以绕过 SSL 拦截。
AZSM1043	无法恢复作业	重试或创建支持票证。
AZSM1044	未能完成作业。	重试或创建支持票证。
AZSM1045	作业仍在运行时被中止。	重试或创建支持票证。
AZSM1060	作业执行期间的杂项错误。	此错误可能由于各种原因而发生。 查看报告的错误，并根据其详细信息采取纠正措施，如下所示。 如果错误指示：1） “InvalidResourceName”：请检查该文件夹和文件名是否遵循受支持的命名约定。 例如，“con”不是有效的目录名称。 2） “指定的共享已满”：验证目标共享的容量。 3） “错误的文件描述符”：确认代理和源之间的 SMB 网络连接正常运行，并且 SMB 服务器响应读取请求。 4） “403 此请求无权执行此作”：如果为目标存储帐户配置了专用终结点，请检查 DNS 是否已正确配置，并验证没有 DNS 错误路由或负载均衡器配置导致 IP 解析不正确。 5） 对于其他错误，请重试作业;如果问题仍然存在，请创建支持票证。
AZSM2021	目标不支持文件类型。	此目标类型不支持此类型的文件。 有关其他信息，请参阅 Azure 文件和 Azure Blob 存储的可伸缩性和性能目标。
AZSM2024	源路径长度超过目标支持的最大长度。	请参阅命名和引用共享、目录、文件和元数据文章中的指南。
AZSM2026	源文件的大小大于目标支持的最大大小。	请参阅命名和引用共享、目录、文件和元数据文章中的指南。
AZSM2027	源文件安全描述符具有不受支持的属性	查看文件或文件夹的权限。
AZSM2061	扫描源时遇到未知错误。	可能是暂时性错误。 重新运行迁移作业。
AZSM2062	由于权限问题，无法读取源文件。	验证代理是否有权访问源位置。
AZSM2063	读取源文件时遇到 I/O 错误。	此错误可能是暂时性的。 再次重试迁移作业。 如果问题仍然存在，请创建支持票证以获取进一步的帮助。
AZSM2069	由于权限问题，无法读取目标文件。	验证代理是否已向目标位置授予权限。
AZSM2070	无法写入 Blob，因为它具有活动租约	该错误可能是由于另一个代理写入该位置造成的。 确保没有针对目标运行其他作业。 重试或创建支持票证。
AZSM2071	传输期间修改了源文件	此错误可能是暂时性的。 再次重试迁移作业。 如果问题仍然存在，请创建支持票证以获取进一步的帮助。
AZSM2080	由于未知错误，复制失败	此错误可能是暂时性的。 再次重试迁移作业。 如果问题仍然存在，请创建支持票证以获取进一步的帮助。

排查存储移动程序基于角色的访问控制的问题

在作业运行期间，会发生自动基于角色的访问控制分配。 如果任务分配失败，请手动添加必需的角色分配。

1. 导航到相应的资源 - Key Vault、文件共享或 Blob 容器。
2. 导航到访问控制（IAM）。
3. 添加新角色分配： 使用 Azure 门户分配 Azure 角色 - Azure RBAC |Microsoft Learn。
4. 在“添加角色分配向导”中，在下表中搜索在步骤 1 中选择的资源类型的适当角色。 在下面的示例中，资源将是 Key Vault。

资源类型	所需角色
Key Vault	Key Vault Secrets 用户
文件共享	存储文件数据特权参与者
Blob 容器	存储 Blob 数据特权参与者

一. 分配访问权限应针对“托管标识”。
二. 在右侧窗格中，将托管标识类型选择为“计算机 - Azure Arc”。
iii. 从列表中选择计算机 arc。 它与代理同名。
四。 完成任务。