지역을 설정합니다. AWS - AWS SDK for JavaScript

AWS SDK for JavaScript V3 API 참조 안내서는 AWS SDK for JavaScript 버전 3(V3)의 모든 API 작업을 자세히 설명합니다.

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

지역을 설정합니다. AWS

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

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

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

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

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

환경 변수를 사용하세요.

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

공유 구성 파일 사용

공유 자격 증명 파일을 통해 SDK에서 사용할 자격 증명을 저장할 수 있는 것처럼 AWS 지역 및 기타 구성 설정을 SDK에서 사용할 이름이 지정된 config 공유 파일에 보관할 수 있습니다. AWS_SDK_LOAD_CONFIG환경 변수가 올바른 값으로 설정된 경우 SDK는 파일이 로드될 때 config 파일을 JavaScript 자동으로 검색합니다. config 파일을 저장하는 위치는 운영 체제에 따라 다릅니다.

  • Linux, macOS 또는 Unix 사용자 – ~/.aws/config

  • Windows 사용자 - C:\Users\USER_NAME\.aws\config

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

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

공유 configcredentials 파일 사용에 관한 자세한 내용은 AWS SDK 및 도구 참조 가이드Shared config and credentials files 단원을 참조하세요.

리전 설정을 위한 우선순위

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

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

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

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