Região da AWS - AWS SDKse ferramentas

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á.

Região da AWS

Regiões da AWS são um conceito importante a ser entendido ao trabalhar com Serviços da AWS.

Com Regiões da AWS, você pode acessar aqueles 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 AWS service (Serviço da AWS) solicitações 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, comoIAM, 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 Serviços da AWS, SDKs use uma classe/objeto cliente para cada um. AWS service (Serviço da AWS) Se seu aplicativo precisar acessar a AmazonEC2, por exemplo, seu aplicativo criará um objeto EC2 cliente da Amazon para interagir com esse serviço.

Se nenhuma região for especificada explicitamente para o cliente no próprio código, o cliente usará como padrão a região definida por meio da configuração a seguir. region 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 é especificada durante a instanciação desse cliente, específica para o seu SDK (consulte seu SDK Guia específico ou sua base SDK de código).

Configure essa funcionalidade usando o seguinte:

region- configuração de AWS config arquivo compartilhado
AWS_REGION: variável de ambiente
aws.region- propriedade JVM do sistema: somente Java/Kotlin

Especifica o padrão Região da AWS a ser usado para AWS solicitações. Essa região é usada para solicitações SDK de serviço 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-1 define o endpoint para a Região da AWS Leste dos EUA (Norte da Virgínia).

  • aws-globalespecifica o endpoint global para serviços que oferecem suporte a um endpoint global separado, além dos endpoints regionais, como AWS Security Token Service ()AWS STS e 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 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 seu guia específico para AWS SDK desenvolvedores.

Compatibilidade com AWS SDKs

Os itens a seguir SDKs oferecem suporte aos recursos e configurações descritos neste tópico. Quaisquer exceções parciais estão anotadas. Todas as configurações de propriedade do JVM sistema são suportadas pelo AWS SDK for Java e pelo AWS SDK para Kotlin único.

SDK Compatível Notas ou mais informações
AWS CLI v2 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 AWS CLI v1 usa uma variável de ambiente nomeada AWS_DEFAULT_REGION para essa finalidade.
SDKpara C++ Sim
SDKpara Go V2 (1.x) Sim
SDKpara 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.
SDKpara Java 2.x Sim
SDKpara Java 1.x Sim
SDKpara JavaScript 3.x Sim
SDKpara JavaScript 2.x Sim
SDKpara Kotlin Sim
SDKpara. NET3.x Sim
SDKpara PHP 3.x Sim
SDKpara Python (Boto3) Sim Isso SDK usa uma variável de ambiente nomeada AWS_DEFAULT_REGION para essa finalidade.
SDKpara Ruby 3.x Sim
SDKpara Rust Sim
SDKpara Swift Sim
Ferramentas para PowerShell Sim