AWS 리전 - AWS SDKs 및 도구
AWS SDK 및 도구 지원

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

AWS 리전

참고

설정 페이지의 레이아웃을 이해하거나, 이어지는 AWS SDK 및 도구 지원 표를 해석하는 데 도움이 되는 정보는 이 안내서의 설정 페이지의 이해에서 확인하세요.

AWS 리전은 AWS 서비스 작업 시 이해해야 할 중요한 개념입니다.

AWS 리전을 사용하면 물리적으로 특정 지역에 있는 AWS 서비스에 액세스할 수 있습니다. 이는 데이터와 애플리케이션이 귀사 및 귀사의 사용자가 액세스하기 가까운 곳에서 계속 실행되도록 하는 데 도움이 될 수 있습니다. 리전에서는 내결함성, 안정성 및 복원성을 지원하고 지연 시간을 줄일 수도 있습니다. 리전을 통해 사용자는 가용 상태를 유지하며 리전 중단의 영향을 받지 않는 중복 리소스를 생성할 수 있습니다.

대부분의 AWS 서비스 요청은 특정한 지리적 리전과 관련이 있습니다. 한 리전에서 생성한 리소스는 AWS 서비스 서비스에서 제공하는 복제 기능을 명시적으로 사용하지 않는 한 다른 리전에 존재하지 않습니다. 예를 들어, Amazon S3와 Amazon EC2 크로스 리전 복제를 지원합니다. IAM과 같은 일부 서비스의 경우 리전 리소스가 없습니다.

AWS 일반 참조에는 다음 정보가 포함됩니다.

서비스 클라이언트 생성

프로그래밍 방식으로 AWS 서비스에 액세스하기 위해 SDK는 각각의 AWS 서비스에 대해 클라이언트 클래스/객체를 사용합니다. 예를 들어 애플리케이션에서 Amazon EC2에 액세스해야 하는 경우 애플리케이션은 Amazon EC2 클라이언트 객체를 생성하여 해당 서비스와 인터페이스합니다.

코드에서 클라이언트에 대해 리전이 명시적으로 지정되지 않은 경우, 클라이언트는 다음 region 설정을 통해 지정된 리전을 기본값으로 사용합니다. 하지만 개별 클라이언트 객체에 대해 클라이언트의 활성 리전을 명시적으로 설정할 수 있습니다. 이러한 방식으로 리전을 설정하면 특별한 서비스 클라이언트에 대한 전역 설정에 우선합니다. 대체 리전은 해당 클라이언트를 인스턴스화하는 동안 SDK에 따라 지정됩니다(특정 SDK 가이드 또는 SDK의 코드 베이스 확인).

다음을 사용하여 이 기능을 구성하십시오.

region- 공유 AWS config 파일 설정
AWS_REGION - 환경 변수
aws.region - JVM 시스템 속성: Java/Kotlin만 해당

AWS요청에 사용할 기본값 AWS 리전을 지정합니다. 이 리전은 사용할 특정 지역과 함께 제공되지 않은 SDK 서비스 요청에 사용됩니다.

기본값: 없음. 이 값을 명시적으로 지정해야 합니다.

유효값:

  • AWS 일반 참조의 AWS 서비스 엔드포인트에 나열된 대로 선택한 서비스에서 사용할 수 있는 모든 리전 코드. 예를 들어, us-east-1 값은 엔드포인트를 AWS 리전 미국 동부(버지니아 북부)로 설정합니다.

  • aws-global을 사용하면 리전 엔드포인트 외에 AWS Security Token Service(AWS STS)및 Amazon Simple Storage Service(Amazon S3)와 같이 별도의 글로벌 엔드포인트를 지원하는 서비스에 글로벌 엔드포인트를 지정할 수 있습니다.

config 파일에서 이 값을 설정하는 예:

[default]
region = us-west-2

명령 행을 통한 환경 변수 설정의 Linux/macOS 예제:

export AWS_REGION=us-west-2

명령줄을 통해 환경 변수를 설정하는 Windows 예제:

setx AWS_REGION us-west-2

대부분의 SDK에는 애플리케이션 코드 내에서 기본 리전을 설정하는 데 사용할 수 있는 “구성” 객체가 있습니다. 자세한 내용은 특정 AWS SDK 개발자 안내서를 참조하십시오.

AWS SDK 및 도구 지원

다음 SDK는 이 주제에서 설명하는 기능 및 설정을 지원합니다. 모든 일부 예외가 기록됩니다. 모든 JVM 시스템 속성 설정은 AWS SDK for Java 및 AWS SDK for Kotlin에서만 지원됩니다.

SDK 지원 참고 또는 추가 정보
AWS CLI v2 예 AWS CLI v2는 값이 AWS_DEFAULT_REGION에 값이 입력되기 전에 AWS_REGION의 값을 사용합니다(두 변수 모두 선택됨).
AWS CLI v1 예 AWS CLI v1은 이 용도로 명명된 AWS_DEFAULT_REGION 환경 변수를 사용합니다.
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 예
SDK for JavaScript 3.x 예
SDK for JavaScript 2.x 예
SDK for Kotlin 예
SDK for .NET 4.x 예
SDK for .NET 3.x 예
SDK for PHP 3.x 예
SDK for Python (Boto3) 예 이 SDK는 이러한 용도로 명명된 AWS_DEFAULT_REGION 환경 변수를 사용합니다.
SDK for Ruby 3.x 예
SDK for Rust 예
SDK for Swift 예
Tools for PowerShell V5 예
Tools for PowerShell V4 예