Configuration des clients de service dans le AWS SDK pour Ruby - AWS SDK pour Ruby
Priorité des paramètres

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 des clients de service dans le AWS SDK pour Ruby

Pour y accéder par programmation Services AWS, le AWS SDK pour Ruby utilise une classe client pour chacun d'entre eux. Service AWS Par exemple, si votre application doit accéder à Amazon EC2, elle crée un objet EC2 client Amazon pour interagir avec ce service. Vous utilisez ensuite le client du service pour y faire des demandes Service AWS.

Pour faire une demande à un Service AWS, vous devez d'abord créer un client de service. Pour chaque Service AWS élément utilisé par votre code, il possède sa propre gemme et son propre type dédié pour interagir avec lui. Le client expose une méthode pour chaque opération d'API exposée par le service.

Il existe de nombreuses méthodes alternatives pour configurer le comportement du SDK, mais en fin de compte, tout dépend du comportement des clients du service. Toute configuration n'a aucun effet tant qu'un client de service créé à partir de celles-ci n'est pas utilisé.

Vous devez définir la manière dont votre code s'authentifie AWS lorsque vous développez avec Services AWS. Vous devez également définir le Région AWS que vous souhaitez utiliser.

Le guide de référence AWS SDKs and Tools contient également des paramètres, des fonctionnalités et d'autres concepts fondamentaux communs à de AWS SDKs nombreux.

Rubriques

Les credentialsfichiers partagés config peuvent être utilisés pour les paramètres de configuration. Pour tous les paramètres du AWS SDK, consultez la référence des paramètres dans le guide de référence des outils AWS SDKs et des outils.

Différents profils peuvent être utilisés pour stocker différentes configurations. Pour spécifier le profil actif chargé par le SDK, vous pouvez utiliser la variable d'AWS_PROFILEenvironnement ou l'profileoption deAws.config.

Priorité des paramètres

Les paramètres globaux configurent les fonctionnalités, les fournisseurs d'informations d'identification et les autres fonctionnalités prises en charge par la plupart des SDKs utilisateurs et ayant un large impact sur tous Services AWS. Tous AWS SDKs ont une série de lieux (ou de sources) qu'ils vérifient afin de trouver une valeur pour les paramètres globaux. Les paramètres ne sont pas tous disponibles dans toutes les sources. La définition de la priorité de recherche est la suivante :

  1. Tout paramètre explicite défini dans le code ou sur un client de service lui-même a priorité sur tout autre paramètre.

    1. Tous les paramètres transmis directement au constructeur d'un client ont la priorité la plus élevée.

    2. Aws.configest vérifié pour les paramètres globaux ou spécifiques au service.

  2. La variable d'environnement est contrôlée.

  3. Le AWS credentials fichier partagé est vérifié.

  4. Le AWS config fichier partagé est vérifié.

  5. Toute valeur par défaut fournie par le code source du AWS SDK for Ruby lui-même est utilisée en dernier.