数据存储库任务失败故障排除 - FSx for Lustre

数据存储库任务失败故障排除

可以启用 CloudWatch Logs 日志记录,以记录在使用数据文件库任务导入或导出文件时遭遇失败的信息。有关 CloudWatch Logs 事件日志的更多信息,请参阅数据存储库事件日志

当数据存储库任务失败时,您可以在控制台的任务状态页面上的未成功导出的文件中找到 Amazon FSx 处理失败的文件数量。或者,您可以使用 CLI 或 API 并查看任务的 Status: FailedCount 属性。有关访问此信息的信息,请参阅访问数据存储库任务

对于数据存储库任务,Amazon FSx 还可以选择在完成报告中提供有关失败的特定文件及目录的信息。任务完成报告包含 Lustre 文件系统上失败的文件或目录路径及其状态和失败原因。有关更多信息,请参阅 使用任务完成报告

数据存储库任务失败可能具有多种原因,包括以下列出的原因。

错误代码 说明

FileSizeTooLarge

Amazon S3 支持的最大对象大小为 5TiB。

InternalError

导入、导出或释放任务的 Amazon FSx 文件系统中出现错误。通常,此错误代码表示运行失败任务的 Amazon FSx 文件系统处于“失败”生命周期状态。发生这种情况时,受影响的文件可能会由于数据丢失而无法恢复。否则,您可以使用分层存储管理(HSM)命令将文件和目录导出到 S3 上的数据存储库。有关更多信息,请参阅 使用 HSM 命令导出文件

OperationNotPermitted

Amazon FSx 无法释放该文件,因为它尚未导出到关联的 S3 存储桶中。您必须使用自动导出或导出数据存储库任务来确保先将您的文件导出到关联的 Amazon S3 桶中。

PathSizeTooLong

导出路径过长。S3 支持的最大对象键长度为 1024 个字符。

ResourceBusy

Amazon FSx 无法导出或释放该文件,因为文件系统上的另一个客户端正在访问该文件。您可以在工作流程完成对文件的写入后重试 DataRepositoryTask。

S3AccessDenied

执行数据存储库导出或导入任务时拒绝访问 Amazon S3。

对于导出任务,Amazon FSx 文件系统必须具有执行 S3:PutObject 操作的权限,才能导出到 S3 上关联的数据存储库。此权限在 AWSServiceRoleForFSxS3Access_fs-0123456789abcdef0 服务相关角色中授予。有关更多信息,请参阅 使用 Amazon FSx 的服务相关角色

对于导出任务,由于导出任务要求数据流出文件系统的 VPC,因此如果目标存储库的桶策略包含 aws:SourceVpcaws:SourceVpce IAM 全局条件键之一,则可能会发生此错误。

对于导入任务,Amazon FSx 文件系统必须具有执行 S3:HeadObjectS3:GetObject 操作的权限,才能从 S3 上关联的数据存储库导入。

对于导入任务,如果您的 S3 桶使用服务器端加密以及存储在 AWS Key Management Service 中的客户托管密钥(SSE-KMS),则必须遵循使用服务器端加密的 Amazon S3 桶中的策略配置。

如果您的 S3 桶包含从与您的文件系统关联的 S3 桶账户不同的 AWS 账户 上传的对象,则可以确保您的数据存储库任务可以修改 S3 元数据或覆盖 S3 对象,而不管是从哪个账户上传的这些对象。我们建议您为 S3 桶启用 S3 对象所有权功能。借助此功能,可强制上传以提供 -/-acl bucket-owner-full-control 标准 ACL,从而获得其他 AWS 账户 上传到桶的新对象的所有权。可以通过在 S3 桶中选择桶拥有者优先选项来启用 S3 对象所有权。有关更多信息,请参阅《Amazon S3 用户指南》中的使用 S3 对象所有权控制已上传对象的所有权

S3Error

Amazon FSx 遇到了与 S3 相关的错误,但并非 S3AccessDenied

S3FileDeleted

Amazon FSx 无法导出硬链接文件,因为数据存储库中不存在源文件。

S3ObjectInUnsupportedTier

Amazon FSx 成功从 S3 Glacier Flexible Retrieval 或 S3 Glacier Deep Archive 存储类导入了一个非符号关联对象。在任务完成报告中,FileStatus 将是 succeeded with warning。警告显示,如要检索数据,必须先还原 S3 Glacier Flexible Retrieval 或 S3 Glacier Deep Archive 对象,然后再使用 hsm_restore 命令导入对象。

S3ObjectNotFound

Amazon FSx 无法导入或导出文件,因为数据存储库中不存在相应的文件。

S3ObjectPathNotPosixCompliant

Amazon S3 对象存在但无法导入,因为它不是 POSIX 兼容的对象。有关支持的 POSIX 元数据的信息,请参阅针对数据存储库的 POSIX 元数据支持

S3ObjectUpdateInProgressFromFileRename

Amazon FSx 无法释放该文件,因为自动导出正在处理该文件的重命名。必须先完成自动导出重命名,才能释放文件。

S3SymlinkInUnsupportedTier

Amazon FSx 无法导入符号链接对象,因为该对象属于不支持的 Amazon S3 存储类,例如 S3 Glacier Flexible Retrieval 或 S3 Glacier Deep Archive 存储类。在任务完成报告中,FileStatus 将是 failed

SourceObjectDeletedBeforeReleasing

Amazon FSx 无法从文件系统中释放该文件,因为在释放该文件前已将其从数据存储库中删除。