Configuration par service - AWS SDK for JavaScript

Le guide de API référence AWS SDK for JavaScript V3 décrit en détail toutes les API opérations de la AWS SDK for JavaScript version 3 (V3).

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Configuration par service

Vous pouvez configurer le SDK en transmettant les informations de configuration à un objet de service.

La configuration au niveau des services fournit un contrôle significatif sur les services individuels, ce qui vous permet de mettre à jour la configuration des objets de service individuels lorsque vos besoins diffèrent de la configuration par défaut.

Note

Dans la version 2.x du AWS SDK for JavaScript service, la configuration pouvait être transmise à des constructeurs clients individuels. Toutefois, ces configurations seraient d'abord fusionnées automatiquement dans une copie de la SDK configuration globaleAWS.config.

De plus, appeler AWS.config.update({/* params *}) uniquement la configuration mise à jour pour les clients de service instanciés après l'appel de mise à jour, pas pour les clients existants.

Ce comportement était une source fréquente de confusion et a rendu difficile l'ajout d'une configuration à l'objet global qui n'affecte qu'un sous-ensemble de clients de service d'une manière compatible avec la transmission. Dans la version 3, il n'existe plus de configuration globale gérée par leSDK. La configuration doit être transmise à chaque client de service instancié. Il est toujours possible de partager la même configuration entre plusieurs clients, mais cette configuration ne sera pas automatiquement fusionnée avec un état global.

Définir la configuration par service

Chaque service que vous utilisez dans le SDK formulaire JavaScript est accessible via un objet de service qui fait partie du API pour ce service. Par exemple, pour accéder au service Amazon S3, vous créez l'objet de service Amazon S3. Vous pouvez spécifier les paramètres de configuration spécifiques à un service dans le cadre du constructeur pour cet objet de service.

Par exemple, si vous devez accéder à EC2 des objets Amazon dans plusieurs AWS régions, créez un objet de EC2 service Amazon pour chaque région, puis définissez la configuration régionale de chaque objet de service en conséquence.

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