Configuração por serviço - AWS SDK for JavaScript

O Guia de API referência da AWS SDK for JavaScript V3 descreve detalhadamente todas as API operações da AWS SDK for JavaScript versão 3 (V3).

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

Configuração por serviço

Você pode configurar o SDK passando as informações de configuração para um objeto de serviço.

A configuração em nível de serviço fornece controle significativo sobre serviços individuais, permitindo que você atualize a configuração de objetos de serviço individuais quando suas necessidades variam da configuração padrão.

nota

Na versão 2.x, a configuração do AWS SDK for JavaScript serviço pode ser passada para construtores de clientes individuais. No entanto, essas configurações primeiro seriam mescladas automaticamente em uma cópia da configuração globalSDK. AWS.config

Além disso, a chamada de AWS.config.update({/* params *}) somente atualizou a configuração para clientes de serviço instanciados depois que a chamada de atualização foi feita, e não para clientes existentes.

Esse comportamento era uma fonte frequente de confusão e dificultava a adição de configuração ao objeto global que afeta apenas um subconjunto de clientes de serviço de forma compatível com versões futuras. Na versão 3, não há mais uma configuração global gerenciada peloSDK. A configuração deve ser transmitida para cada cliente de serviço instanciado. Ainda é possível compartilhar a mesma configuração entre vários clientes, mas essa configuração não será automaticamente mesclada com um estado global.

Defina a configuração por serviço

Cada serviço que você usa no SDK for JavaScript é acessado por meio de um objeto de serviço que faz parte do API para esse serviço. Por exemplo, para acessar o serviço Amazon S3, você cria o objeto de serviço Amazon S3. Especifique as definições de configuração específicas de um serviço como parte do construtor desse objeto de serviço.

Por exemplo, se você precisar acessar EC2 objetos da Amazon em várias AWS regiões, crie um objeto de EC2 serviço da Amazon para cada região e, em seguida, defina a configuração regional de cada objeto de serviço adequadamente.

var ec2_regionA = new EC2({region: 'ap-southeast-2', maxAttempts: 15}); var ec2_regionB = new EC2({region: 'us-west-2', maxAttempts: 15});