AWS SDK for JavaScript v2가 지원 종료에 도달했습니다. [AWS SDK for JavaScript v3](https://docs.aws.amazon.com//sdk-for-javascript/v3/developer-guide/)로 마이그레이션하실 것을 권장합니다. 마이그레이션 방법에 대한 자세한 내용은 해당 [공지 사항](https://aws.amazon.com/blogs//developer/announcing-end-of-support-for-aws-sdk-for-javascript-v2/)을 참조하세요.
# 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 리전 및 엔드포인트](https://docs.aws.amazon.com/general/latest/gr/rande.html) 섹션을 참조하세요.
## 환경 변수 사용
`AWS_REGION` 환경 변수를 사용하여 리전을 설정할 수 있습니다. 이 변수를 정의하면 SDK for JavaScript가 해당 변수를 읽고 사용합니다.
## 공유 구성 파일 사용
공유 자격 증명 파일에 SDK에서 사용할 자격 증명을 저장할 수 있는 것과 마찬가지로 SDK에서 사용하는 `config`라는 공유 파일에 리전 및 기타 구성 설정을 보관할 수 있습니다. `AWS_SDK_LOAD_CONFIG` 환경 변수가 임의의 값으로 설정된 경우 SDK for JavaScript는 로드 시 `config` 파일을 자동으로 검색합니다. ` config` 파일을 저장하는 위치는 운영 체제에 따라 다릅니다.
+ Linux, macOS 또는 Unix 사용자: `~/.aws/config`
+ Windows 사용자: `C:\Users\USER_NAME\.aws\config`
아직 공유 `config` 파일이 없는 경우, 지정된 디렉터리에 하나를 생성할 수 있습니다. 다음 예제의 경우 `config` 파일에서 리전과 출력 형식을 둘 다 설정합니다.
```
[default]
region=us-east-1
output=json
```
공유 구성 및 자격 증명 파일 사용에 대한 자세한 내용은 *AWS Command Line Interface 사용 설명서*의 [공유 인증 자격 증명 파일에서 Node.js에 인증 자격 증명 로드](loading-node-credentials-shared.md) 또는 [구성 및 자격 증명](https://docs.aws.amazon.com/cli/latest/userguide/cli-config-files.html) 섹션을 참조하세요.
## 리전 설정을 위한 우선 순위
리전 설정의 우선 순위는 다음과 같습니다.
+ 어떤 리전이 클라이언트 클래스 생성자로 전달된 경우 이 리전이 사용됩니다. 그렇지 않은 경우...
+ 어떤 리전이 글로벌 구성 객체에 설정된 경우 이 리전이 사용됩니다. 그렇지 않은 경우...
+ `AWS_REGION` 환경 변수가 [진리(truthy)](https://developer.mozilla.org/en-US/docs/Glossary/Truthy) 값인 경우 이 리전이 사용됩니다. 그렇지 않은 경우...
+ `AMAZON_REGION` 환경 변수가 진리(truthy) 값인 경우 이 리전이 사용됩니다. 그렇지 않은 경우...
+ `AWS_SDK_LOAD_CONFIG` 환경 변수가 임의의 값으로 설정되어 있고 공유 자격 증명 파일(`~/.aws/credentials` 또는 `AWS_SHARED_CREDENTIALS_FILE`에 표시된 경로)에 구성된 프로필의 리전이 포함된 경우 이 리전이 사용됩니다. 그렇지 않은 경우...
+ `AWS_SDK_LOAD_CONFIG` 환경 변수가 임의의 값으로 설정되어 있고 구성 파일(`~/.aws/config` 또는 `AWS_CONFIG_FILE`에 표시된 경로)에 구성된 프로필의 리전이 포함된 경우 이 리전이 사용됩니다.