Effectuer des Service AWS requêtes à l'aide du AWS SDK pour Ruby - AWS SDK pour Ruby

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.

Effectuer des Service AWS requêtes à l'aide du AWS SDK pour Ruby

Pour y accéder par programmation Services AWS, SDKs utilisez 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 envoyer une demande à un Service AWS, vous devez d'abord créer et configurer 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.

Chaque client de service a besoin d'un Région AWS et d'un fournisseur d'informations d'identification. Le SDK utilise ces valeurs pour envoyer des demandes à la région appropriée pour vos ressources et pour signer les demandes avec les informations d'identification correctes. Vous pouvez spécifier ces valeurs par programmation dans le code ou les charger automatiquement depuis l'environnement.

  • Lors de l'instanciation d'une classe client, des AWS informations d'identification doivent être fournies. Pour connaître l'ordre dans lequel le SDK vérifie les fournisseurs d'authentification, consultezChaîne de fournisseurs d'identifiants.

  • Le SDK possède une série d'emplacements (ou de sources) qu'il vérifie afin de trouver une valeur pour les paramètres de configuration. Pour en savoir plus, consultez Priorité des paramètres.

Le SDK pour Ruby inclut des classes clientes qui fournissent des interfaces au Services AWS. Chaque classe de clients prend en charge un particulier Service AWS et suit la conventionAws::<service identifier>::Client. Par exemple, Aws::S3::Clientfournit une interface au service Amazon Simple Storage Service et Aws::SQS::Clientfournit une interface au service Amazon Simple Queue Service.

Toutes les classes clientes pour tous Services AWS sont sûres dans un contexte multithread.

Vous pouvez transmettre les options de configuration directement aux constructeurs de clients et de ressources. Ces options ont priorité sur l'environnement et les Aws.config valeurs par défaut. 

# using a credentials object
ec2 = Aws::EC2::Client.new(region: 'us-west-2', credentials: credentials)