기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 데이터 리포지토리 작업 실패 문제 해결
<a name="failed-tasks"></a>

CloudWatch Logs [로깅을 활성화하여](cw-event-logging.md) 데이터 리포지토리 작업을 사용하여 파일을 가져오거나 내보내는 동안 발생한 모든 오류에 대한 정보를 기록할 수 있습니다. CloudWatch Logs 이벤트 로그에 대한 자세한 내용은 [데이터 리포지토리 이벤트 로그](data-repo-event-logs.md) 섹션을 참조하세요.

데이터 리포지토리 작업이 실패하는 경우 콘솔의 **작업 상태** 페이지에서 Amazon FSx가 처리하지 못한 파일 수를 **파일 내보내기 실패**에서 확인할 수 있습니다. 또는 CLI 또는 API를 사용하여 작업의 `Status: FailedCount` 속성을 볼 수 있습니다. 이 정보에 액세스하는 방법에 대한 자세한 내용은 [데이터 리포지토리 작업 액세스](view-data-repo-tasks.md) 섹션을 참조하세요.

데이터 리포지토리 작업의 경우 Amazon FSx는 완료 보고서에서 실패한 특정 파일 및 디렉터리에 대한 정보도 선택적으로 제공합니다. 작업 완료 보고서에는 장애가 발생한 Lustre 파일 시스템의 파일 또는 디렉터리 경로, 상태 및 실패 이유가 포함됩니다. 자세한 내용은 [작업 완료 보고서 사용](task-completion-report.md) 단원을 참조하십시오.

데이터 리포지토리 작업은 다음과 같은 여러 가지 이유로 실패할 수 있습니다.


| 오류 코드 | 설명 | 
| --- | --- | 
| `FileSizeTooLarge` | Amazon S3에서 지원하는 최대 객체 크기는 5TiB입니다. | 
| `InternalError` | Amazon FSx 파일 시스템에서 가져오기, 내보내기 또는 릴리스 작업과 관련하여 오류가 발생했습니다. 일반적으로 이 오류 코드는 실패한 작업이 실행된 Amazon FSx 파일 시스템이 FAILED 수명 주기 상태임을 의미합니다. 이 경우 데이터 손실로 인해 영향을 받은 파일을 복구하지 못할 수 있습니다. 그렇지 않으면 계층적 스토리지 관리(HSM) 명령을 사용하여 파일 및 디렉터리를 S3의 데이터 리포지토리로 내보낼 수 있습니다. 자세한 내용은 [HSM 명령을 사용하여 파일 내보내기](exporting-files-hsm.md) 단원을 참조하십시오. | 
| `OperationNotPermitted` | Amazon FSx가 연결된 S3 버킷으로 파일을 내보내지 않았기 때문에 파일을 릴리스하지 못했습니다. 파일을 먼저 연결된 Amazon S3 버킷으로 내보내려면 데이터 리포지토리 자동 내보내기 또는 내보내기 작업을 사용해야 합니다. | 
| `PathSizeTooLong` | 내보내기 경로가 너무 깁니다. S3에서 지원하는 최대 객체 키 길이는 1,024자입니다. | 
| `ResourceBusy` | Amazon FSx는 파일 시스템의 다른 클라이언트가 액세스하고 있었기 때문에 파일을 내보내거나 릴리스하지 못했습니다. 워크플로가 파일 쓰기를 완료한 후 DataRepositoryTask를 다시 시도할 수 있습니다. | 
| `S3AccessDenied` | Amazon S3에 대한 데이터 리포지토리 내보내기 또는 가져오기 작업에 대한 액세스가 거부되었습니다.<br />내보내기 작업의 경우 Amazon FSx 파일 시스템에 S3의 연결된 데이터 리포지토리로 내보내기 작업을 수행할 `S3:PutObject` 권한이 있어야 합니다. 이 권한은 `AWSServiceRoleForFSxS3Access_{{fs-0123456789abcdef0}}` 서비스 연결 역할에서 부여됩니다. 자세한 내용은 [Amazon FSx에 대해 서비스 연결 역할 사용](using-service-linked-roles.md) 섹션을 참조하세요.<br />내보내기 작업의 경우 내보내기 작업을 수행하려면 데이터가 파일 시스템의 VPC 외부로 이동해야 하므로 대상 리포지토리에 `aws:SourceVpc` 또는 `aws:SourceVpce` IAM 글로벌 조건 키 중 하나가 포함된 버킷 정책이 있는 경우 이 오류가 발생할 수 있습니다.<br />가져오기 작업의 경우 Amazon FSx 파일 시스템에 S3의 연결된 데이터 리포지토리에서 가져오기 위한 `S3:HeadObject` 및 `S3:GetObject` 작업을 수행할 권한이 있어야 합니다.<br />가져오기 작업의 경우 S3 버킷이 AWS Key Management Service (SSE-KMS)에 저장된 고객 관리형 키와 함께 서버 측 암호화를 사용하는 경우의 정책 구성을 따라야 합니다[서버 측 암호화된 Amazon S3 버킷 사용](s3-server-side-encryption-support.md).<br />S3 버킷에 파일 시스템 연결 S3 버킷 계정 AWS 계정 과 다른에서 업로드된 객체가 포함된 경우 데이터 리포지토리 작업이 S3 메타데이터를 수정하거나 업로드한 계정에 관계없이 S3 객체를 덮어쓸 수 있는지 확인할 수 있습니다. S3 버킷에 대해 S3 객체 소유권 기능을 활성화하는 것이 좋습니다. 이 기능을 사용하면 AWS 계정 업로드가 `-/-acl bucket-owner-full-control` 미리 준비된 ACL을 제공하도록 강제하여 다른이 버킷에 업로드하는 새 객체의 소유권을 가질 수 있습니다. S3 버킷에서 **버킷 소유자 선호** 옵션을 선택하여 S3 객체 소유권을 활성화합니다. 자세한 내용은 *Amazon S3 사용 설명서*의 [S3 객체 소유권을 사용하여 업로드된 객체의 소유권 제어](https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html)를 참조하세요. | 
| `S3Error` | Amazon FSx에서 S3 관련 오류가 발생했지만 `S3AccessDenied`가 아니었습니다. | 
| `S3FileDeleted` | 원본 파일이 데이터 리포지토리에 없기 때문에 Amazon FSx에서 하드 링크 파일을 내보낼 수 없었습니다. | 
| `S3ObjectInUnsupportedTier` | Amazon FSx는 S3 Glacier Flexible Retrieving 또는 S3 Glacier Deep Archive 스토리지 클래스에서 심볼링크가 아닌 객체를 가져왔습니다. `FileStatus`가 작업 완료 보고서에 `succeeded with warning` 상태로 표시됩니다. 이 경고는 데이터를 검색하려면 먼저 S3 Glacier Flexible Retrieve 또는 S3 Glacier Deep Archive 객체를 복원한 다음 `hsm_restore` 명령을 사용하여 객체를 가져와야 한다는 의미입니다. | 
| `S3ObjectNotFound` | Amazon FSx는 파일이 데이터 리포지토리에 없기 때문에 파일을 가져오거나 내보낼 수 없었습니다. | 
| `S3ObjectPathNotPosixCompliant` | Amazon S3 객체가 존재하지만 POSIX 호환 객체가 아니므로 가져올 수 없습니다. 지원되는 POSIX 메타데이터에 대한 자세한 내용은 [데이터 리포지토리에 대한 POSIX 메타데이터 지원](posix-metadata-support.md) 섹션을 참조하세요. | 
| `S3ObjectUpdateInProgressFromFileRename` | 자동 내보내기가 파일 이름 변경을 처리하고 있기 때문에 Amazon FSx에서 파일을 릴리스할 수 없습니다. 자동 내보내기 이름 변경 프로세스를 완료해야 파일을 릴리스할 수 있습니다. | 
| `S3SymlinkInUnsupportedTier` | Amazon FSx는 S3 Glacier Flexible Retrieve 또는 S3 Glacier Deep Archive 스토리지 클래스와 같이 지원되지 않는 Amazon S3 스토리지 클래스에 있으므로 심볼링크 객체를 가져올 수 없습니다. `FileStatus`가 작업 완료 보고서에 `failed` 상태로 표시됩니다. | 
| `SourceObjectDeletedBeforeReleasing` | 파일이 릴리스되기 전에 데이터 리포지토리에서 삭제되었기 때문에 Amazon FSx는 파일 시스템에서 파일을 릴리스하지 못했습니다. |