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

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

Configuração por serviço

Você pode configurar o SDK passando 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 do AWS SDK para JavaScript, a configuração do serviço pode ser passada para construtores de clientes individuais. No entanto, essas configurações primeiro serão mescladas automaticamente em uma cópia da configuração global do SDK: 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 pelo SDK. 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.

Definir a configuração por serviço

Cada serviço usado no SDK para JavaScript é acessado por meio de um objeto de serviço que faz parte da API desse 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 objetos do Amazon EC2 em várias regiões da AWS, crie um objeto de serviço do Amazon EC2 para cada região e defina a configuração da região de cada objeto de serviço de acordo.

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