S3 File Gateway에 대한 캐시 보고서 생성 - AWS Storage Gateway

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

S3 File Gateway에 대한 캐시 보고서 생성

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

사전 조건

  • 게이트웨이에는 캐시 보고서를 저장할 Amazon S3 버킷에 대한 s3:PutObject 및 s3:AbortMultipartUpload 권한이 있어야 합니다.

  • 현재 파일 공유에 대해 진행 중인 다른 캐시 보고서는 없습니다.

  • 파일 공유에 대한 기존 캐시 보고서가 10개 미만이어야 합니다.

  • 게이트웨이는 온라인 상태여야 하며에 연결되어 있어야 합니다 AWS.

  • 게이트웨이 루트 디스크에는 최소 20GB의 여유 공간이 있어야 합니다.

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

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

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

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

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

  5. IAM 역할의 경우 다음 중 하나를 수행하여 캐시 보고서를 생성하고 저장할 수 있는 권한을 File Gateway에 부여하는 IAM 역할을 지정합니다.

    • 기존 IAM 역할을 지정하려면 드롭다운 목록에서 역할을 선택합니다.

    • 새 IAM 역할을 수동으로 생성하려면 역할 생성을 선택한 다음 IAM 콘솔을 사용하여 새 역할을 생성합니다.

    참고

    지정하는 IAM 역할에는 보고서 버킷 Amazon S3 위치에 객체를 쓰고 보고서 버킷에 대한 멀티파트 업로드를 중지할 수 있는 다음과 같은 권한이 있어야 합니다.

    • s3:PutObject

    • s3:AbortMultipartUpload

    또한 역할은 storagegateway.amazonaws.com 서비스가 sts:AssumeRole 작업을 사용하여 역할을 수임하도록 허용해야 합니다.

  6. 보고서 필터에서 다음 중 하나를 수행하여 캐시 보고서에 포함할 파일을 결정합니다.

    • 현재 Amazon S3에 업로드에 실패한 캐시된 모든 파일을 포함하려면 업로드에 실패한 모든 파일을 선택합니다.

    • 특정 이유로 Amazon S3에 업로드하지 못한 파일만 포함하려면 특정 업로드 실패 이유만 선택합니다. 그런 다음 실패 이유에서 다음 이유 중 하나 이상을 선택합니다.

      • 액세스할 수 없는 스토리지 클래스 - 게이트웨이는 객체가 저장된 Amazon S3 스토리지 클래스에 액세스할 수 없습니다. 자세한 내용은 오류: InaccessibleStorageClass를 참조하세요.

      • 잘못된 객체 상태 - 게이트웨이의 파일 상태가 Amazon S3의 상태와 일치하지 않습니다. 자세한 내용은 오류: InvalidObjectState를 참조하세요.

      • 객체 누락 - Amazon S3에서 객체가 삭제되거나 이동되었습니다. 자세한 내용은 오류: ObjectMissing을 참조하세요.

      • S3 액세스 거부됨 - Amazon S3 버킷 액세스 IAM 역할은 게이트웨이가 업로드 작업을 수행하도록 허용하지 않습니다. 자세한 내용은 오류: S3AccessDenied를 참조하세요.

    참고

    업로드 실패 파일 플래그는 24시간마다 게이트웨이 재부팅 중에 재설정됩니다. 이 보고서가 재설정 후 다시 플래그가 지정되기 전에 파일을 캡처하면 업로드에 실패한 파일로 보고되지 않습니다.

  7. 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 버킷에 연결할 수 없는 경우 캐시 보고서 생성이 실패합니다.

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

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

  9. 완료되면 보고서 생성을 선택합니다.

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