Configurando clientes de serviço no AWS SDK for 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á.

Configurando clientes de serviço no AWS SDK for Ruby

Para acessar programaticamente Serviços da AWS, o AWS SDK for Ruby usa uma classe cliente para cada um. AWS service (Serviço da AWS) Por exemplo, se seu aplicativo precisa acessar a Amazon EC2, seu aplicativo cria um objeto EC2 cliente da Amazon 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 uma solicitação a um AWS service (Serviço da AWS), primeiro você deve criar um cliente de serviço. Para cada uso que AWS service (Serviço da AWS) seu código usa, ele tem sua própria gema e seu próprio tipo dedicado para interagir com ela. O cliente expõe um método para cada operação de API exposta pelo serviço.

Há muitas formas alternativas de configurar o comportamento do SDK, mas, em última análise, tudo tem a ver com o comportamento dos clientes do serviço. Qualquer configuração não tem efeito até que um cliente de serviço criado a partir delas seja usado.

Você deve estabelecer como seu código é autenticado AWS quando você desenvolve com Serviços da AWS. Você também deve definir o que Região da AWS deseja usar.

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

Tópicos

O Compartilhado config e credentials os arquivos podem ser usados para configurações. Para todas as configurações do AWS SDK, consulte a referência de configurações no Guia AWS SDKs de referência de ferramentas.

Perfis diferentes podem ser usados para armazenar configurações diferentes. Para especificar o perfil ativo que o SDK carrega, você pode usar a variável de AWS_PROFILE ambiente ou a profile opção deAws.config.

Precedência de configurações

As configurações globais definem recursos, provedores de credenciais e outras funcionalidades que são suportadas pela maioria SDKs e têm um amplo impacto em todas Serviços da AWS as áreas. Todos AWS SDKs têm uma série de lugares (ou fontes) que eles verificam 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. Todos os parâmetros passados diretamente para um construtor de cliente têm a maior precedência.

    2. Aws.configé verificado quanto às configurações globais ou específicas do serviço.

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

  3. O AWS credentials arquivo compartilhado é verificado.

  4. O AWS config arquivo compartilhado é verificado.

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