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

Definir a Região da AWS para o AWS SDK para Ruby

Você pode acessar Serviços da AWS que operem em uma área geográfica específica usando Regiões da AWS. Isso pode ser útil para redundância e para manter os dados e as aplicações em execução próximo ao lugar onde você e os usuários as acessarão.

Você deve definir um Região da AWS padrão a ser usado pelo SDK para Ruby em solicitações da AWS. Esse padrão é usado para todas as chamadas do método de serviço do SDK que não são especificadas com uma região.

Para obter mais informações sobre a configuração do region, consulte Região da AWS no Guia de referência de ferramentas e SDKs da AWS. Isso também inclui exemplos de como definir a região padrão por meio do arquivo compartilhado config da AWS ou das variáveis ​​de ambiente.

Ordem de pesquisa de região para resolução

Você precisa definir uma região ao usar a maioria dos Serviços da AWS. O AWS SDK para Ruby procura por uma região na seguinte ordem:

Como definir a região

Esta seção descreve diferentes maneiras de definir uma região, começando pela abordagem mais comum.

Definir a região usando o arquivo config compartilhado

Defina a região configurando a variável region no arquivo AWS config compartilhado. Para obter mais informações sobre o arquivo config compartilhado, consulte Arquivos de configuração e credenciais compartilhados no Guia de referência de ferramentas e SDKs da AWS.

Exemplo de configuração desse valor no arquivo config:

[default]
region = us-west-2

O arquivo config compartilhado não é verificado se a variável de ambiente AWS_SDK_CONFIG_OPT_OUT estiver definida.

Definir a região usando variáveis de ambiente

Defina a região definindo a variável de ambiente AWS_REGION.

Use o comando export para definir essa variável em sistemas baseados em Unix, como Linux ou macOS. O exemplo a seguir define a região como us-west-2.

export AWS_REGION=us-west-2

Para configurar essa variável no Windows, use o comando set. O exemplo a seguir define a região como us-west-2.

set AWS_REGION=us-west-2

Definir a região com o Aws.config

Defina a região adicionando um valor region ao hash Aws.config. O exemplo a seguir atualiza o hash Aws.config para usar a região us-west-1.

Aws.config.update({region: 'us-west-1'})

Todos os clientes ou recursos que você criar posteriormente estarão vinculados a essa região.

Definir a região em um objeto de cliente ou de recurso

Defina a região ao criar um cliente ou recurso da AWS. O exemplo a seguir cria um objeto de recurso do Amazon S3 na região us-west-1. Escolha a região correta para seus recursos da AWS. Um objeto de cliente de serviço é imutável, então você deve criar um novo cliente para cada serviço para o qual você faz solicitações e para fazer solicitações ao mesmo serviço usando uma configuração diferente.

s3 = Aws::S3::Resource.new(region: 'us-west-1')