AWS 리전 - AWS SDKs 및 도구
와의 호환성 AWS SDKs

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

AWS 리전

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

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

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

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

서비스 클라이언트 생성

프로그래밍 방식으로 에 액세스하려면 각 에 대해 클라이언트 클래스/객체를 AWS 서비스 SDKs 사용합니다 AWS 서비스. EC2예를 들어 애플리케이션이 Amazon 에 액세스해야 하는 경우 애플리케이션은 해당 서비스와 인터페이스할 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

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

와의 호환성 AWS SDKs

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

SDK 지원 참고 또는 추가 정보
AWS CLI v2 예 AWS CLI v2는 의 값을 의 값AWS_REGION보다 먼저 사용합니다AWS_DEFAULT_REGION(두 변수 모두 선택됨).
AWS CLI v1 예 AWS CLI v1은 이 용도로 AWS_DEFAULT_REGION 이름이 지정된 환경 변수를 사용합니다.
SDK C++용 예
SDK Go V2용(1.x) 예
SDK Go 1.x(V1)용 예 공유 config 파일 설정을 사용하려면 구성 파일에서 로드를 켜야 합니다. 세션을 참조하십시오.
SDK Java 2.x용 예
SDK Java 1.x용 예
SDK JavaScript 3.x용 예
SDK JavaScript 2.x용 예
SDK Kotlin용 예
SDK 용.NET 3.x 예
SDK 3.xPHP용 예
SDK Python용(Boto3) 예 이를 AWS_DEFAULT_REGION 위해 라는 환경 변수를 SDK 사용합니다.
SDK Ruby 3.x용 예
SDK Rust용 예
SDK Swift용 예
용 도구 PowerShell 예