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

# Amazon S3 통합 문제 해결
<a name="s3-integration-troubleshooting"></a>

Amazon S3 버킷에 연결하는 데 문제가 발생하면 다음과 같은 일반적인 원인과 해결 방법을 검토하세요.

## ACL 지원 지식 기반에 표시되지 않는 문서
<a name="s3-troubleshooting-acl-documents-missing"></a>

**문제:** 문서는 ACL 지원 지식 기반에 수집되지 않습니다.

**해결 방법:** ACL 지원 지식 기반의 경우 연결된 ACL 항목이 없는 문서는 수집되지 않습니다. 모든 문서에 글로벌 ACL 파일 또는 메타데이터 파일을 통해 정의된 ACL이 있는지 확인합니다. 자세한 내용은 [문서 수준 ACLs](s3-acl.md) 단원을 참조하십시오.

## 교차 계정 액세스가 구성되지 않음
<a name="s3-troubleshooting-cross-account"></a>

**문제:** 관리자가 Amazon Quick의 다른 계정에서 Amazon S3 버킷을 사용할 수 있는 액세스 권한을 부여하지 않았습니다. AWS 

**해결 방법:** 관리자에게 교차 계정 Amazon S3 액세스 권한을 부여하도록 요청합니다. 자세한 내용은 [Amazon S3 버킷에 대한 Amazon Quick 액세스 권한 부여](s3-admin-setup.md#s3-grant-bucket-access) 단원을 참조하십시오.

## 버킷이 승인된 목록에 없음
<a name="s3-troubleshooting-bucket-not-approved"></a>

**문제:** 액세스하려는 버킷이 관리자의 승인을 받지 않았습니다.

**해결 방법**:
+ 버킷 이름의 철자가 올바른지 확인합니다.
+ 관리자에게 버킷이 승인된 목록에 포함되어 있는지 확인합니다.
+ 필요한 경우 관리자에게 승인된 버킷 목록에 버킷을 추가하도록 요청합니다.

## IAM 권한 부족
<a name="s3-troubleshooting-iam-permissions"></a>

**문제:** IAM 역할 또는 사용자에게 Amazon S3 버킷에 액세스하는 데 필요한 권한이 없습니다.

**해결 방법**:
+ IAM 정책에 필요한 Amazon S3 권한이 포함되어 있는지 확인합니다.
  + `s3:GetObject`
  + `s3:ListBucket`
  + `s3:GetBucketLocation`
  + `s3:GetObjectVersion`
  + `s3:ListBucketVersions`
+ 자체 버킷에서 액세스를 차단할 수 있는 명시적 거부 문이 있는지 확인합니다.

**참고**  
ARN`arn:aws:iam::account-id:role/service-role/aws-quicksight-service-role-v0`은 사용자 지정 역할이 생성되지 않은 경우 사용되는 기본 서비스 역할입니다. 사용자 지정 서비스 역할이 있는 경우 관리자에게 문의하여 사용자 지정 서비스 역할 ARN을 얻고 기본값 대신 사용합니다.

## 교차 리전 제한
<a name="s3-troubleshooting-cross-region"></a>

**문제:** Amazon S3 버킷이 Amazon Quick 계정 또는 서비스와 다른 AWS 리전에 있습니다.

**해결 방법**:
+ 버킷 리전이 Amazon Quick 서비스 리전과 일치하는지 확인합니다.
+  AWS CLI를 사용하여 버킷 리전을 확인합니다. `aws s3api get-bucket-location --bucket bucket-name` 
+ 서비스와 동일한 리전에 있는 버킷을 사용합니다.

## 추가 문제 해결 단계
<a name="s3-troubleshooting-additional-steps"></a>
+  AWS CLI를 사용하여 **버킷 접근성을 테스트**합니다.

  ```
  aws s3 ls s3://bucket-name --profile your-profile
  ```
+ AccessDenied 오류에 대한** CloudTrail 로그를 검토하여** 특정 권한 문제를 식별합니다.
+ **Amazon S3 퍼블릭 액세스 차단 설정을 확인하세요**. 이러한 설정은 일반적으로 인증된 액세스에 영향을 주지 않지만 특정 사용 사례를 방해하지 않는지 확인합니다.
+ **버킷 소유권 확인** - 버킷이 존재하고 버킷 이름이 올바른지 확인합니다.