AWS SDK for JavaScript v2가 지원 종료에 도달했습니다. AWS SDK for JavaScript v3로 마이그레이션하실 것을 권장합니다. 마이그레이션 방법에 대한 자세한 내용은 해당 공지 사항을 참조하세요.

AWS 리전 설정

리전은 동일한 지리적 영역 내에서 명명된 AWS 리소스 집합입니다. 예를 들면, 미국 동부(버지니아 북부) 리전은 us-east-1입니다. SDK for JavaScript를 구성할 때 리전을 지정하면 SDK가 해당 리전의 리소스에 액세스할 수 있습니다. 일부 서비스는 특정 리전에서만 사용할 수 있습니다.

SDK for JavaScript는 기본적으로 리전을 선택하지 않습니다. 그러나 환경 변수, 공유 config 파일 또는 글로벌 구성 객체를 사용하여 리전을 설정할 수 있습니다.

클라이언트 클래스 생성자에서

서비스 객체를 인스턴스화할 때 다음과 같이 해당 리소스의 리전을 클라이언트 클래스 생성자의 일부로 지정할 수 있습니다.

var s3 = new AWS.S3({apiVersion: '2006-03-01', region: 'us-east-1'});

글로벌 구성 객체 사용하기

JavaScript 코드에서 리전을 설정하려면 다음과 같이 AWS.Config 글로벌 구성 객체를 업데이트해야 합니다.

AWS.config.update({region: 'us-east-1'});

현재 리전 및 각 리전에서 사용 가능한 서비스에 대한 자세한 내용은 AWS 일반 참조의 AWS 리전 및 엔드포인트 섹션을 참조하세요.

환경 변수 사용

AWS_REGION 환경 변수를 사용하여 리전을 설정할 수 있습니다. 이 변수를 정의하면 SDK for JavaScript가 해당 변수를 읽고 사용합니다.

공유 구성 파일 사용

공유 자격 증명 파일에 SDK에서 사용할 자격 증명을 저장할 수 있는 것과 마찬가지로 SDK에서 사용하는 config라는 공유 파일에 리전 및 기타 구성 설정을 보관할 수 있습니다. AWS_SDK_LOAD_CONFIG 환경 변수가 임의의 값으로 설정된 경우 SDK for JavaScript는 로드 시 config 파일을 자동으로 검색합니다. config 파일을 저장하는 위치는 운영 체제에 따라 다릅니다.

아직 공유 config 파일이 없는 경우, 지정된 디렉터리에 하나를 생성할 수 있습니다. 다음 예제의 경우 config 파일에서 리전과 출력 형식을 둘 다 설정합니다.

[default]
   region=us-east-1
   output=json

공유 구성 및 자격 증명 파일 사용에 대한 자세한 내용은 AWS Command Line Interface 사용 설명서의 공유 인증 자격 증명 파일에서 Node.js에 인증 자격 증명 로드 또는 구성 및 자격 증명 섹션을 참조하세요.

리전 설정을 위한 우선 순위

리전 설정의 우선 순위는 다음과 같습니다.