Amazon S3 액세스 포인트
참고
설정 페이지의 레이아웃을 이해하거나, 이어지는 AWS SDK 및 도구 지원 표를 해석하는 데 도움이 되는 정보는 이 안내서의 설정 페이지의 이해에서 확인하세요.
Amazon S3 서비스는 Amazon S3 버킷과의 상호 작용 대체 방법으로 액세스 포인트를 제공합니다. 액세스 포인트는 버킷에 직접 적용되지 않고 S3 버킷에 고유한 정책 및 구성을 적용할 수 있습니다. AWSSDK를 사용하면 API 작업 버킷 필드에 버킷 이름을 명시적으로 지정하지 않고 액세스 포인트 Amazon 리소스 이름(ARN)을 사용할 수 있습니다. 액세스 포인트 ARN과 GetObject 을 사용하여 버킷에서 객체를 가져오거나, 액세스 포인트 ARN과 PutObject을 사용하여 버킷에 객체를 추가하는 등의 특정 작업에 이 방법을 사용합니다.
Amazon S3 액세스 포인트 및 ARN에 대한 자세한 내용은 Amazon S3 사용 설명서의 액세스 포인트 사용을 참조하십시오.
다음을 사용하여 이 기능을 구성하십시오.
s3_use_arn_region- 공유 AWSconfig파일 설정AWS_S3_USE_ARN_REGION- 환경 변수aws.s3UseArnRegion- JVM 시스템 속성: Java/Kotlin만 해당- 코드에서 값을 직접 구성하려면 특정 SDK를 직접 참조하십시오.
-
이 설정은 SDK가 액세스 포인트 ARN AWS 리전을 사용하여 요청에 대한 지역 엔드포인트를 구성할지 여부를 제어합니다. AWS 리전SDK는 클라이언트가 AWS 리전 구성한 동일한 AWS 파티션으로 ARN 을 제공하는지 검증하여 실패할 가능성이 높은 파티션 간 호출이 발생하지 않도록 합니다. 다중 정의의 경우 코드로 구성된 설정이 우선 적용되고 환경 변수 설정이 그 뒤를 따릅니다.
기본값:
false유효값:
-
true— SDK는 엔드포인트를 구성할 때 클라이언트가 구성 엔드포인트 대신 ARN AWS 리전을 사용합니다. AWS 리전 예외: 클라이언트가 구성한 AWS 리전이 FIPS AWS 리전인 경우 이는 ARN과 일치해야 합니다. AWS 리전 이렇게 하지 않으면 오류가 발생합니다. -
false— SDK는 엔드포인트를 구성할 클라이너트가 구성한 AWS 리전을 사용합니다.
-
AWS SDK 및 도구 지원
다음 SDK는 이 주제에서 설명하는 기능 및 설정을 지원합니다. 모든 일부 예외가 기록됩니다. 모든 JVM 시스템 속성 설정은 AWS SDK for Java 및 AWS SDK for Kotlin에서만 지원됩니다.
| SDK | 지원 | 참고 또는 추가 정보 |
|---|---|---|
| AWS CLI v2 | 예 | |
| SDK for C++ | 예 | |
| SDK for Go V2 (1.x) |
예 | |
| SDK for Go 1.x (V1) | 예 | 공유 config 파일 설정을 사용하려면 구성 파일에서 로드를 켜야 합니다. 세션을 참조하십시오. |
| SDK for Java 2.x | 예 | |
| SDK for Java 1.x | 예 | JVM 시스템 속성은 지원되지 않습니다. |
| SDK for JavaScript 3.x | 예 | |
| SDK for JavaScript 2.x | 예 | |
| SDK for Kotlin | 예 | |
| SDK for .NET 4.x | 예 | |
| SDK for .NET 3.x | 예 | 표준 우선순위를 따르지 않습니다. 공유 config 파일 값이 환경 변수보다 우선합니다. |
| SDK for PHP 3.x | 예 | |
| SDK for Python (Boto3) |
예 | |
| SDK for Ruby 3.x | 예 | |
| SDK for Rust | 아니요 | |
| SDK for Swift | 아니요 | |
| Tools for PowerShell V5 | 예 | 표준 우선순위를 따르지 않습니다. 공유 config 파일 값이 환경 변수보다 우선합니다. |
| Tools for PowerShell V4 | 예 | 표준 우선순위를 따르지 않습니다. 공유 config 파일 값이 환경 변수보다 우선합니다. |
