O [Guia de referência da API do AWS SDK para JavaScript V3](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/) descreve em detalhes todas as operações da API para o AWS SDK para JavaScript versão 3 (V3). 

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Defina a AWS região
<a name="setting-region"></a>

Uma AWS região é um conjunto nomeado de AWS recursos na mesma área geográfica. Um exemplo de uma Região é `us-east-1`, que é a Região Leste dos EUA (Norte da Virgínia). Você especifica uma região ao criar um cliente de serviço no SDK para JavaScript que o SDK acesse o serviço nessa região. Alguns serviços só estão disponíveis em regiões específicas.

O SDK do JavaScript não seleciona uma região por padrão. No entanto, você pode definir a AWS Região usando uma variável de ambiente ou um `config` arquivo de configuração compartilhado.

## Em um construtor de classes do cliente
<a name="setting-region-constructor"></a>

Ao instanciar um objeto de serviço, você pode especificar a AWS região desse recurso como parte do construtor da classe cliente, conforme mostrado aqui.

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

## Usar uma variável de ambiente
<a name="setting-region-environment-variable"></a>

Defina a região usando a variável de ambiente `AWS_REGION`. Se você definir essa variável, o SDK para a JavaScript lê e a usa.

## Usar um arquivo config compartilhado
<a name="setting-region-config-file"></a>

Assim como o arquivo de credenciais compartilhado permite armazenar credenciais para uso pelo SDK, você pode manter sua AWS região e outras configurações em um arquivo compartilhado com o nome `config` do SDK a ser usado. Se a variável de `AWS_SDK_LOAD_CONFIG` ambiente for definida como um valor verdadeiro, o SDK JavaScript pesquisará automaticamente um `config` arquivo quando ele for carregado. Onde você salva o arquivo `config` depende do sistema operacional:
+ Usuários de Linux, macOS ou Unix: `~/.aws/config`
+ Usuários do Windows: `C:\Users\USER_NAME\.aws\config`

Se não tiver um arquivo `config` compartilhado, você poderá criar um no diretório designado. No exemplo a seguir, o arquivo `config` define a região e o formato de saída.

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

Para obter mais informações sobre como usar arquivos compartilhados `config` e `credentials` arquivos, consulte Arquivos de [configuração e credenciais compartilhados no Guia](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html) de *referência de ferramentas AWS SDKs e ferramentas*.

## Ordem de precedência para definir a região
<a name="setting-region-order-of-precedence"></a>

A ordem de precedência de definição da região é a seguinte:

1. Se uma região for passada para um construtor de classe de cliente, essa região será usada.

1. Se uma região for definida na variável de ambiente, essa região será usada.

1. Caso contrário, a região definida no arquivo de configuração compartilhado será usada.