곧 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에 인증 자격 증명 로드 또는 구성 및 자격 증명 섹션을 참조하세요.

리전 설정을 위한 우선 순위

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