O AWS SDK para JavaScript v2 chegou ao fim do suporte. Recomendamos migrar para o [AWS SDK para JavaScript v3](https://docs.aws.amazon.com//sdk-for-javascript/v3/developer-guide/). Para ver detalhes e informações sobre como migrar, consulte este [anúncio](https://aws.amazon.com/blogs//developer/announcing-end-of-support-for-aws-sdk-for-javascript-v2/).

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

Uma região é um conjunto de recursos da AWS nomeado 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 configurar o SDK para , de maneira que o SDK acesse os recursos nessa região. Alguns serviços só estão disponíveis em regiões específicas.

O SDK para JavaScript. não seleciona uma região por padrão. No entanto, é possível definir a região usando uma variável de ambiente, um arquivo `config` compartilhado ou o objeto de configuração global.

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

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

```
var s3 = new AWS.S3({apiVersion: '2006-03-01', region: 'us-east-1'});
```

## Usar o objeto de configuração global
<a name="setting-region-config-object"></a>

Para definir a região no código JavaScript, atualize o objeto de configuração global `AWS.Config` conforme mostrado aqui.

```
AWS.config.update({region: 'us-east-1'});
```

Para obter mais informações sobre regiões atuais e serviços disponíveis em cada região, consulte [Regiões e endpoints da AWS](https://docs.aws.amazon.com/general/latest/gr/rande.html) na *Referência geral da AWS*.

## 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 JavaScript vai lê-la e usá-la.

## Usar um arquivo de configuração compartilhado
<a name="setting-region-config-file"></a>

Assim como o arquivo de credenciais compartilhado permite armazenar credenciais a serem usadas pelo SDK, é possível manter a região e outras definições de configuração compartilhadas em um arquivo chamado `config` usado pelos SDKs. Caso a variável de ambiente `AWS_SDK_LOAD_CONFIG` tenha sido definida como qualquer valor, o SDK para JavaScript procurará automaticamente um arquivo `config` quando ele for carregado. Onde você salva o arquivo ` config` depende do sistema operacional:
+ Usuários do macOS ou do 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-east-1
   output=json
```

Para obter mais informações sobre como usar arquivos de configuração e credenciais compartilhados, consulte o [Carregar credenciais em Node.js do arquivo de credenciais compartilhado](loading-node-credentials-shared.md) ou [Arquivos de configuração e credencial](https://docs.aws.amazon.com/cli/latest/userguide/cli-config-files.html) no *Guia de usuário do AWS Command Line Interface*.

## 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:
+ Se uma região for passada para um construtor de classe de cliente, essa região será usada. Do contrário...
+ Se uma região for definida no objeto de configuração global, essa região será usada. Do contrário...
+ Se a variável de ambiente `AWS_REGION` for um valor [confiável](https://developer.mozilla.org/en-US/docs/Glossary/Truthy), essa região será usada. Do contrário...
+ Se a variável de ambiente `AMAZON_REGION` for um valor confiável, essa região será usada. Do contrário...
+ Se a variável de ambiente `AWS_SDK_LOAD_CONFIG` for definida como qualquer valor e o arquivo de credenciais compartilhado (`~/.aws/credentials` ou o caminho indicado por `AWS_SHARED_CREDENTIALS_FILE`) contiver uma região para o perfil configurado, será usada essa região. Do contrário...
+ Se a variável de ambiente `AWS_SDK_LOAD_CONFIG` for definida como qualquer valor e o arquivo de configuração (`~/.aws/config` ou o caminho indicado por `AWS_CONFIG_FILE`) contiver uma região para o perfil configurado, será usada essa região.