[AWS SDK for JavaScript V3 API 참조 안내서](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/)는 AWS SDK for JavaScript 버전 3(V3)의 모든 API 작업을 자세히 설명합니다.

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

# AWS 리전 설정
<a name="setting-region"></a>

 AWS 리전은 동일한 지리적 영역에 있는 명명된 AWS 리소스 집합입니다. 리전의 한 가지 예로 미국 동부(버지니아 북부) 리전인 `us-east-1`을 들 수 있습니다. SDK가 해당 리전의 서비스에 액세스할 수 있도록 SDK for JavaScript에서 서비스 클라이언트를 생성할 때 리전을 지정합니다. 일부 서비스는 특정 리전에서만 사용할 수 있습니다.

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

## 클라이언트 클래스 생성자에서
<a name="setting-region-constructor"></a>

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

```
const s3Client = new S3.S3Client({region: 'us-west-2'});
```

## 환경 변수 사용
<a name="setting-region-environment-variable"></a>

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

## 공유 구성 파일 사용
<a name="setting-region-config-file"></a>

공유 자격 증명 파일을 사용하면 SDK에서 사용할 자격 증명을 저장할 수 있는 것과 마찬가지로 AWS 리전 및 기타 구성 설정을 `config` SDK에서 사용할 공유 파일에 보관할 수 있습니다. `AWS_SDK_LOAD_CONFIG` 환경 변수가 진리 값(truthy value)으로 설정된 경우 SDK for JavaScript는 로드 시 `config` 파일을 자동으로 검색합니다. `config` 파일을 저장하는 위치는 운영 체제에 따라 다릅니다.
+ Linux, macOS 또는 Unix 사용자 – `~/.aws/config`
+ Windows 사용자 - `C:\Users\USER_NAME\.aws\config`

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

```
[default]
   region=us-west-2
   output=json
```

공유 `config` 및 `credentials` 파일 사용에 관한 자세한 내용은 *AWS SDK 및 도구 참조 가이드*의 [Shared config and credentials files](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html) 단원을 참조하세요.

## 리전 설정을 위한 우선순위
<a name="setting-region-order-of-precedence"></a>

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

1. 어떤 리전이 클라이언트 클래스 생성자로 전달된 경우 이 리전이 사용됩니다.

1. 환경 변수에 리전을 설정한 경우 이 리전이 사용됩니다.

1. 그렇지 않으면 공유 구성 파일에 정의된 리전이 사용됩니다.