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

# S3 File Gateway에 대한 캐시 보고서 생성
<a name="create-cache-report"></a>

이제 S3 File Gateway는 현재 특정 파일 공유의 로컬 업로드 캐시에 있는 파일에 대한 메타데이터 보고서를 생성할 수 있습니다. 보고서에 표시되는 캐시된 파일의 특정 유형을 결정하는 필터와 추가 기준을 적용할 수 있습니다. 이 보고서를 사용하여 게이트웨이 문제를 식별하고 해결할 수 있습니다. 예를 들어 게이트웨이에서 Amazon S3로 업로드하는 데 실패한 파일이 있는 경우 업로드에 실패한 특정 파일과 업로드 실패 이유를 나열하는 보고서를 생성할 수 있습니다. 보고서는 지정한 필터 파라미터 세트와 일치하는 파일 목록이 포함된 CSV 파일입니다. 출력 파일은 보고서를 구성할 때 지정한 버킷 위치에 Amazon S3 객체로 저장됩니다. AWS Storage Gateway API를 사용하여 캐시 보고서를 생성하려면 *Storage Gateway API 참조*의 [StartCacheReport](https://docs.aws.amazon.com/storagegateway/latest/APIReference/API_StartCacheReport.html)를 참조하세요. Storage Gateway 콘솔에서 캐시 보고서를 생성하려면 다음 절차를 사용합니다.

**사전 조건**
+ 캐시 보고서를 저장할 Amazon S3 버킷에 대한 `s3:PutObject` 및 `s3:AbortMultipartUpload` 권한이 게이트웨이에 있어야 합니다.
+ 현재 파일 공유에 대해 진행 중인 다른 캐시 보고서가 없어야 합니다.
+ 파일 공유에 대한 기존 캐시 보고서가 10개 미만이어야 합니다.
+ 게이트웨이는 온라인 상태여야 하며에 연결되어 있어야 합니다 AWS.
+ 게이트웨이 루트 디스크에 최소 20GB의 여유 공간이 있어야 합니다.

**Storage Gateway 콘솔을 사용하여 캐시 보고서를 생성하려면**

1. Storage Gateway 콘솔([https://console.aws.amazon.com/storagegateway/home/](https://console.aws.amazon.com/storagegateway/home/))을 엽니다.

1. 페이지 왼쪽의 탐색 창에서 **파일 공유**를 선택한 다음 캐시 보고서를 생성할 파일 공유를 선택합니다.

1. **작업** 드롭다운 메뉴에서 **캐시 보고서 생성**을 선택합니다.

1. **Amazon S3 위치**에 Amazon S3 버킷과 완료된 캐시 보고서 CSV 파일 객체를 Amazon S3에 저장할 위치의 접두사를 입력합니다. 기존 Amazon S3 스토리지에서 버킷과 접두사를 선택하려면 **S3 찾아보**기를 선택합니다.

1. **IAM 역할**의 경우 다음 중 하나를 수행하여 캐시 보고서를 생성하고 저장할 수 있는 권한을 File Gateway에 부여하는 IAM 역할을 지정합니다.
   + 기존 IAM 역할을 지정하려면 드롭다운 목록에서 역할을 선택합니다.
   + 새 IAM 역할을 수동으로 생성하려면 **역할 생성**을 선택한 다음 IAM 콘솔을 사용하여 새 역할을 생성합니다.
**참고**  
보고서 버킷 **Amazon S3 위치**에 객체를 쓰고 보고서 버킷으로의 멀티파트 업로드를 중지하려면 지정한 IAM 역할에 다음 권한이 있어야 합니다.  
`s3:PutObject`
`s3:AbortMultipartUpload`
또한 이 역할은 `storagegateway.amazonaws.com` 서비스가 `sts:AssumeRole` 작업을 사용하여 역할을 수임하도록 허용해야 합니다.

1. **보고서 필터**의 경우 다음 중 하나를 수행하여 캐시 보고서에 포함할 파일을 결정합니다.
   + 현재 Amazon S3에 업로드에 실패한 캐시된 모든 파일을 포함하려면 **업로드에 실패한 모든 파일**을 선택합니다.
   + 특정 이유로 Amazon S3에 업로드하지 못한 파일만 포함하려면 **특정 업로드 실패 이유만**을 선택합니다. 그런 다음 **실패의 이유**로 다음 이유 중 하나 이상을 선택합니다.
     + 액세스할 수 없는 스토리지 클래스 - 게이트웨이에서 객체가 저장된 Amazon S3 스토리지 클래스에 액세스할 수 없습니다. 자세한 내용은 [오류: InaccessibleStorageClass](https://docs.aws.amazon.com/filegateway/latest/files3/troubleshooting-file-gateway-issues.html#troubleshoot-logging-errors-inaccessiblestorageclass)를 참조하세요.
     + 잘못된 객체 상태 - 게이트웨이의 파일 상태가 Amazon S3의 파일 상태와 일치하지 않습니다. 자세한 내용은 [오류: InvalidObjectState](https://docs.aws.amazon.com/filegateway/latest/files3/troubleshooting-file-gateway-issues.html#troubleshoot-logging-errors-invalidobjectstate)를 참조하세요.
     + 객체 누락 - 객체가 Amazon S3에서 삭제 또는 이동되었습니다. 자세한 내용은 [오류: ObjectMissing](https://docs.aws.amazon.com/filegateway/latest/files3/troubleshooting-file-gateway-issues.html#troubleshoot-logging-errors-objectmissing)을 참조하세요.
     + S3 액세스 거부 - Amazon S3 버킷 액세스 IAM 역할이 게이트웨이가 업로드 작업을 수행하는 것을 허용하지 않습니다. 자세한 내용은 [오류: S3AccessDenied](https://docs.aws.amazon.com/filegateway/latest/files3/troubleshooting-file-gateway-issues.html#troubleshoot-logging-errors-s3accessdenied)를 참조하세요.
**참고**  
**파일 업로드 실패** 플래그는 24시간마다 그리고 게이트웨이 재부팅 중에 재설정됩니다. 이 보고서가 재설정 후 다시 플래그가 지정되기 전에 파일을 캡처하는 경우 해당 파일은 **파일 업로드 실패**로 보고되지 않습니다.

1. **VPC 엔드포인트를 사용하여 S3에 연결?**에서 다음 중 하나를 수행하여 게이트웨이가 Amazon S3 버킷에 연결하는 방법을 지정합니다.
   + Amazon VPC를 사용하지 않고 직접 연결하려면 **버킷에 직접 연결**을 선택합니다.
   + 기존 Amazon VPC 엔드포인트 목록을 찾아보려면 **VPC 엔드포인트 선택**을 선택한 다음 나타나는 **VPC 엔드포인트 드롭다운 목록에서 엔드포인트**를 지정합니다.
   + DNS 이름으로 기존 Amazon VPC 엔드포인트를 지정하려면 **VPC 엔드포인트 DNS 이름 입력**을 선택한 다음 나타나는 **VPC 엔드포인트 DNS 이름 필드에 DNS 이름**을 입력합니다.
**참고**  
파일 공유가 VPC 엔드포인트를 사용하여 정상적인 작업을 위해 Amazon S3에 연결하는 경우 캐시 보고서를 구성할 때 동일한 VPC를 사용하는 것이 좋습니다. 게이트웨이가 잘못된 VPC 구성을 포함하여 어떤 이유로든 Amazon S3 버킷에 연결할 수 없는 경우 캐시 보고서 생성이 실패합니다.

1. (선택 사항) **태그 - 선택 사항**에서 **새 태그 추가**를 선택한 다음 캐시 보고서에 대한 **키**와 **값**을 입력합니다.

   태그는 Storage Gateway 리소스를 분류하는 데 도움이 되는 대/소문자를 구분하는 키-값 페어입니다. 태그를 추가하면 캐시 보고서를 더 쉽게 필터링하고 검색할 수 있습니다. 이 단계를 반복하여 최대 50개의 태그를 추가할 수 있습니다.

1. 마친 후에는 **보고서 생성**을 선택합니다.

   Storage Gateway가 보고서 생성을 시작합니다. 파일 공유에 대한 세부 정보 페이지의 **캐시 보고서** 탭에서 진행 상황을 확인하고 상태를 볼 수 있습니다.