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

Configurando o Região da AWS para o AWS SDK for Ruby

Você pode acessar Serviços da AWS essa operação 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 padrão Região da AWS para o SDK for Ruby usar AWS nas solicitações. 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 region configuração, consulte o Guia Região da AWSde referência de ferramentas AWS SDKs e ferramentas. Isso também inclui exemplos de como definir a região padrão por meio do AWS config arquivo compartilhado 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 for Ruby pesquisa 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 definindo a region variável no AWS config arquivo compartilhado. Para obter mais informações sobre o config arquivo compartilhado, consulte Arquivos de configuração e credenciais compartilhados no Guia de referência de ferramentas AWS SDKs e ferramentas.

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 AWS cliente ou recurso. 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 AWS recursos. 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')