A versão 4 (V4) do AWS SDK para .NET foi lançada\!
Para obter informações sobre mudanças significativas e migrar seus aplicativos, consulte o [tópico de migração](https://docs.aws.amazon.com/sdk-for-net/v4/developer-guide/net-dg-v4.html).
[https://docs.aws.amazon.com/sdk-for-net/v4/developer-guide/net-dg-v4.html](https://docs.aws.amazon.com/sdk-for-net/v4/developer-guide/net-dg-v4.html)
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á.
# Definindo a AWS região para o AWS SDK para .NET
AWS As regiões permitem que você acesse AWS serviços que residem fisicamente em uma região geográfica específica. Isso pode ser útil para redundância e para manter os seus dados e aplicativos em execução próximo ao lugar em que você e os seus usuários os acessarão.
Para ver a lista atual de todas as regiões e endpoints compatíveis com cada AWS serviço, consulte [Pontos de extremidade e cotas de serviço](https://docs.aws.amazon.com/general/latest/gr/aws-service-information.html) no. *Referência geral da AWS* Para ver uma lista dos endpoints regionais existentes, consulte [endpoints de serviço da AWS](https://docs.aws.amazon.com/general/latest/gr/rande.html). Para ver informações detalhadas sobre regiões, consulte [Specify which AWS Regions your account can use](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-regions.html).
Você pode criar um cliente AWS de serviço que vá para uma [região específica](#per-client). Você também pode configurar seu aplicativo com uma região que será usada para [todos os clientes do AWS serviço](#globally). Esses dois casos serão explicados a seguir.
## Crie um cliente de serviço com uma região específica
Você pode especificar a região para qualquer um dos clientes de AWS serviço em seu aplicativo. Definir a Região desta maneira tem precedência sobre qualquer configuração global para aquele cliente de serviço particular.
### Região existente
Este exemplo mostra como instanciar um [ EC2 cliente da Amazon](https://docs.aws.amazon.com/sdkfornet/v4/apidocs/items/EC2/TEC2Client.html) em uma região existente. Ele usa [RegionEndpoint](https://docs.aws.amazon.com/sdkfornet/v4/apidocs/items/Amazon/TRegionEndpoint.html)campos definidos.
```
using (AmazonEC2Client ec2Client = new AmazonEC2Client(RegionEndpoint.USWest2))
{
// Make a request to EC2 in the us-west-2 Region using ec2Client
}
```
### Nova região usando RegionEndpoint classe
[Este exemplo mostra como construir um novo endpoint de região usandoRegionEndpoint. GetBySystemName](https://docs.aws.amazon.com/sdkfornet/v4/apidocs/items/Amazon/MRegionEndpointGetBySystemNameString.html).
```
var newRegion = RegionEndpoint.GetBySystemName("us-west-new");
using (var ec2Client = new AmazonEC2Client(newRegion))
{
// Make a request to EC2 in the new Region using ec2Client
}
```
### Nova região usando a classe de configuração do cliente de serviço
Este exemplo mostra como usar a `ServiceURL` propriedade da classe de configuração do cliente de serviço para especificar a região; nesse caso, usando a classe [Amazon EC2 Config](https://docs.aws.amazon.com/sdkfornet/v4/apidocs/items/EC2/TEC2Config.html).
Esta técnica funciona mesmo se o endpoint da região não seguir o padrão regular de endpoints da região.
```
var ec2ClientConfig = new AmazonEC2Config
{
// Specify the endpoint explicitly
ServiceURL = "https://ec2.us-west-new.amazonaws.com"
};
using (var ec2Client = new AmazonEC2Client(ec2ClientConfig))
{
// Make a request to EC2 in the new Region using ec2Client
}
```
## Especifique uma região para todos os clientes de serviço
Há várias maneiras de especificar uma região para todos os clientes de AWS serviço que seu aplicativo cria. Essa região é usada para clientes de serviço que não foram criados com uma região específica.
O AWS SDK para .NET procura por um valor de região na seguinte ordem.
### Perfis
Defina um perfil que seu aplicativo ou o SDK tenha carregado. Para obter mais informações, consulte [Resolução de perfil e credenciais](creds-assign.md).
### Variáveis de ambiente
Defina na variável de ambiente `AWS_REGION`.
No Linux ou macOS:
```
export AWS_REGION='us-west-2'
```
No Windows:
```
set AWS_REGION=us-west-2
```
**nota**
Se você definir essa variável de ambiente para todo o sistema (usando `export` ou`setx`), ela afetará todos SDKs os kits de ferramentas, não apenas o. AWS SDK para .NET
### AWSConfigs classe
Definido como um [AWSConfigs. AWSRegion](https://docs.aws.amazon.com/sdkfornet/v4/apidocs/items/Amazon/TAWSConfigs.html)propriedade.
```
AWSConfigs.AWSRegion = "us-west-2";
using (var ec2Client = new AmazonEC2Client())
{
// Make request to Amazon EC2 in us-west-2 Region using ec2Client
}
```
## Resolução da região
Se nenhum dos métodos descritos acima for usado para especificar um Região da AWS, as AWS SDK para .NET tentativas de encontrar uma região para o cliente do AWS serviço operar.
**Ordem da resolução da região**
1. Arquivos de configuração do aplicativo, como `app.config` e `web.config`.
1. Variáveis de ambiente (`AWS_REGION` e `AWS_DEFAULT_REGION`).
1. Um perfil com o nome especificado por um valor em `AWSConfigs.AWSProfileName`.
1. Um perfil com o nome especificado pela variável de ambiente `AWS_PROFILE`.
1. O perfil `[default]`.
1. Metadados da EC2 instância Amazon (se estiver sendo executada em uma EC2 instância).
Se nenhuma região for encontrada, o SDK lançará uma exceção informando que o cliente do AWS serviço não tem uma região configurada.
## Informações especiais sobre a região da China (Pequim)
Para usar serviços na região China (Pequim), é necessário ter uma conta e credenciais específicas para a região China (Pequim). Contas e credenciais de outras AWS regiões não funcionarão na região da China (Pequim). Da mesma forma, contas e credenciais da região da China (Pequim) não funcionarão para outras AWS regiões. Para ter informações sobre os endpoints e protocolos que estão disponíveis na região China (Pequim), consulte [Endpoints da região Pequim](https://docs.amazonaws.cn/en_us/aws/latest/userguide/endpoints-Beijing.html).
## Informações especiais sobre novos AWS serviços
Novos AWS serviços podem ser lançados inicialmente em algumas regiões e depois suportados em outras regiões. Nestes casos, não é necessário instalar o SDK mais recente para acessar as novas regiões para esse serviço. Você pode especificar regiões recém-adicionadas globalmente ou por cliente, como mostrado anteriormente.