Região da AWS
nota
Para obter ajuda em compreender o layout das páginas de configurações ou interpretar a tabela Compatibilidade com SDKs e ferramentas da AWS a seguir, consulte Entender as páginas de configurações deste guia.
As Regiões da AWS são um conceito importante a ser entendido ao se trabalhar com os Serviços da AWS.
Com as Regiões da AWS, você pode acessar os Serviços da AWS que residem fisicamente em uma área geográfica específica. Isso pode ser útil 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. As regiões fornecem tolerância a falhas, estabilidade e resiliência e também podem reduzir a latência. Com Regiões, você pode criar recursos redundantes que permanecem disponíveis e não são afetados por uma interrupção regional.
A maioria das solicitações dos AWS service (Serviço da AWS) está associada a uma região geográfica específica. Os atributos que você cria em uma Região não existem em qualquer outra Região, a menos que você use explicitamente um atributo de replicação oferecido por AWS service (Serviço da AWS). Por exemplo, o Amazon S3 e o Amazon EC2 oferecem suporte à replicação entre Regiões. Alguns serviços, como o IAM, não têm Recursos regionais.
A Referência geral da AWS contém as seguintes informações:
-
Para entender a relação entre Regiões e endpoints e ver uma lista dos endpoints regionais existentes, consulte Endpoints de serviço da AWS.
-
Para exibir a lista atual de todas as Regiões e endpoints compatíveis para cada AWS service (Serviço da AWS), consulte Endpoints e cotas de serviço.
Criar clientes de serviço
Para acessar programaticamente os Serviços da AWS, os SDKs usam uma classe/objeto cliente para cada AWS service (Serviço da AWS). Se precisar acessar o Amazon EC2, por exemplo, seu aplicativo criará um objeto cliente do Amazon EC2 para interagir com esse serviço.
Se nenhuma região for especificada explicitamente para o cliente, ele usará por padrão a região definida por meio da configuração region a seguir. No entanto, a Região ativa de um cliente pode ser definida explicitamente para qualquer objeto de cliente individual. Definir a Região desta maneira tem precedência sobre qualquer configuração global para aquele cliente de serviço particular. A Região alternativa é definida durante a instanciação desse cliente, específica para seu SDK (consulte o Guia do seu SDK ou a base de código do seu SDK).
Configure essa funcionalidade usando o seguinte:
region: configuração de arquivoconfigda AWS compartilhadoAWS_REGION: variável de ambienteaws.region: propriedade do sistema de JVM: apenas Java/Kotlin-
Especifica a Região da AWS padrão a ser usada para solicitações da AWS. Essa região é usada para solicitações de serviço do SDK que não são fornecidas com uma Região específica para uso.
Valor padrão: nenhum. Você deve especificar esse valor explicitamente.
Valores válidos:
-
Qualquer um dos códigos de Região disponíveis para o serviço escolhido, conforme listado em Endpoints de serviço da AWS na Referência geral da AWS. Por exemplo, o valor
us-east-1define o endpoint para a Região da AWS Leste dos EUA (Norte da Virgínia). -
aws-globalespecifica o endpoint global para serviços compatíveis com um endpoint global, além de endpoints regionais, como AWS Security Token Service (AWS STS) e o Amazon Simple Storage Service (Amazon S3).
-
Exemplo de configuração desse valor no arquivo config:
[default] region = us-west-2
Exemplo de configuração de variáveis de ambiente para Linux/macOS por meio da linha de comando:
export AWS_REGION=us-west-2
Exemplo do Windows de configuração de variáveis de ambiente por meio da linha de comando:
setx AWS_REGION us-west-2
A maioria dos SDKs tem um objeto de “configuração” que está disponível para definir a região padrão a partir do código do aplicativo. Para obter detalhes, consulte o guia específico do desenvolvedor do AWS SDK.
Compatibilidade com SDKs e ferramentas da AWS
Os SDKs a seguir são compatíveis com os recursos e configurações descritos neste tópico. Quaisquer exceções parciais estão anotadas. As configurações de propriedade do sistema de JVM são compatíveis apenas como o AWS SDK para Java e o AWS SDK para Kotlin.
| SDK | Compatível | Notas ou mais informações |
|---|---|---|
| AWS CLI v2 da2 | Sim | AWS CLI v2 usa qualquer valor em AWS_REGION antes de qualquer valor em AWS_DEFAULT_REGION (ambas as variáveis são verificadas). |
| AWS CLI v1 | Sim | A AWS CLI v1 usa uma variável de ambiente nomeada AWS_DEFAULT_REGION para essa finalidade. |
| SDK para C++ | Sim | |
| SDK para Go V2 (1.x) |
Sim | |
| SDK para Go 1.x (V1) | Sim | Para usar as configurações do arquivo config compartilhado, você deve ativar o carregamento do arquivo de configuração; consulte Sessões. |
| SDK para Java 2.x | Sim | |
| SDK para Java 1.x | Sim | |
| SDK para JavaScript 3.x | Sim | |
| SDK para JavaScript 2.x | Sim | |
| SDK para Kotlin | Sim | |
| SDK para .NET 4.x | Sim | |
| SDK para .NET 3.x | Sim | |
| SDK para PHP 3.x | Sim | |
| SDK para Python (Boto3) |
Sim | Este SDK usa uma variável de ambiente nomeada AWS_DEFAULT_REGION para essa finalidade. |
| SDK para Ruby 3.x | Sim | |
| SDK para Rust | Sim | |
| SDK para Swift | Sim | |
| Ferramentas para PowerShell V5 | Sim | |
| Ferramentas para PowerShell V4 | Sim |