Configurar clientes de serviço no AWS SDK para Ruby - AWS SDK para Ruby
Precedência de configurações

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

Configurar clientes de serviço no AWS SDK para Ruby

Para acessar programaticamente os Serviços da AWS, o AWS SDK para Ruby usa uma classe de cliente para cada AWS service (Serviço da AWS). Se seu aplicativo precisar acessar o Amazon EC2, por exemplo, seu aplicativo criará um objeto cliente do Amazon EC2 para interagir com esse serviço. Em seguida, você usa o cliente de serviço para fazer solicitações para esse AWS service (Serviço da AWS).

Para fazer requisições a um AWS service (Serviço da AWS), você primeiro cria um cliente de serviço. Para cada AWS service (Serviço da AWS) utilizado pelo seu código, ele tem seu próprio gem e tipo dedicado para interagir com ele. O cliente expõe um método para cada operação de API exposta pelo serviço.

Há muitas maneiras alternativas de configurar o comportamento do SDK, mas tudo está relacionado ao comportamento dos clientes de serviço. Nenhuma configuração tem efeito até que um cliente de serviço criado com base nela seja utilizado.

Você precisa estabelecer como seu código faz a autenticação com a AWS ao desenvolver com os Serviços da AWS. Você também deve definir a Região da AWS que deseja usar.

O Guia de referência de SDKs e ferramentas da AWS também contém configurações, recursos e outros conceitos fundamentais comuns entre muitos dos AWS SDKs.

Tópicos

Os arquivos config e credentials compartilhados podem ser usados ​​para definição de configurações. Para todas as configurações do AWS SDK, consulte a seção Referência de configurações no Guia de referência de AWS SDKs e ferramentas.

É possível usar perfis diferentes para armazenar configurações diferentes. Para especificar o perfil ativo que o SDK carrega, você pode usar a variável de ambiente AWS_PROFILE ou a opção profile de Aws.config.

Precedência de configurações

As configurações globais definem atributos, provedores de credenciais e outras funcionalidades que são suportadas pela maioria dos SDKs e têm um amplo impacto nos Serviços da AWS. Todos os AWS SDKs têm uma série de locais (ou fontes) que eles conferem para encontrar um valor para as configurações globais. Nem todas as configurações estão disponíveis em todas as fontes. A seguir está a configuração da precedência de pesquisa:

  1. Qualquer configuração explícita definida no código ou no próprio cliente de serviço tem precedência sobre qualquer outra coisa.

    1. Quaisquer parâmetros passados ​​diretamente para um construtor de cliente têm a maior precedência.

    2. Aws.config é verificada para configurações globais ou específicas de serviço.

  2. A variável de ambiente está marcada.

  3. O arquivo compartilhado AWS credentials foi verificado.

  4. O arquivo compartilhado AWS config foi conferido.

  5. Qualquer valor padrão fornecido pelo próprio código-fonte do AWS SDK para Ruby é usado por último.