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 código do AWS SDK para Ruby no código

Quando a configuração é tratada diretamente no código, o escopo da configuração é limitado à aplicação que usa esse código. Dentro dessa aplicação, há opções para a configuração global de todos os clientes de serviço, a configuração para todos os clientes de determinado tipo de AWS service (Serviço da AWS) ou a configuração para uma instância específica do cliente de serviço.

Aws.config

Para fornecer configuração global em seu código para todas as classes da AWS, use Aws.config que está disponível na gem aws-sdk-core.

Aws.config oferece suporte duas sintaxes para usos diferentes. As configurações globais podem ser aplicadas a todos os Serviços da AWS ou a um serviço específico. Para acessar a lista completa de configurações aceitas, consulte Client Options na Referência da API AWS SDK para Ruby.

Configurações globais por meio de Aws.config

Para definir configurações independentes de serviço por meio de Aws.config, use a seguinte sintaxe:

Aws.config[:<global setting name>] = <value>

Essas configurações são incorporadas a todos os clientes de serviço criados.

Exemplo de configuração global:

Aws.config[:region] = 'us-west-2'

Se você tentar usar um nome de configuração que não seja globalmente compatível, um erro será gerado ao tentar criar uma instância de um tipo de serviço que não seja compatível com ele. Caso isso aconteça, utilize a sintaxe específica do serviço.

Configurações específicas do serviço por meio de Aws.config

Para definir configurações específicas do serviço por meio de Aws.config, use a seguinte sintaxe:

Aws.config[:<service identifier>] = { <global setting name>: <value> }

Essas configurações são incorporadas a todos os clientes de serviço criados para esse tipo de serviço.

Exemplo de uma configuração que se aplica somente ao Amazon S3:

 Aws.config[:s3] = { force_path_style: true }

É possível identificar <service identifier> observando o nome do AWS SDK correspondente para o nome da gem do Ruby e usando o sufixo que segue "aws-sdk-". Por exemplo: