Glossaire

Les services disposent d'une ou de plusieurs versions d'API et la version que vous utilisez détermine les opérations et les paramètres valides. Le format des versions d'API est similaire à celui d'une date. Par exemple, la dernière version de l'API pour Amazon S3 est2006-03-01. Spécifiez une version lorsque vous configurez un objet client.

Les objets client permettent d'exécuter des opérations pour un service. Chaque service pris en charge dans le kit SDK est associé à un objet client. Les objets clients ont des méthodes qui correspondent aux opérations du service. ne-to-one Consultez le guide d’utilisation de base pour en savoir plus sur la création et l’utilisation d’objets client.

Les objets de commande encapsulent l'exécution d'une opération. Lorsque vous suivez les modèles d’utilisation de base du kit SDK, vous n’utilisez pas directement les objets de commande. Vous pouvez accéder aux objets de commande à l'aide de la méthode getCommand() d'un client afin de pouvoir utiliser les fonctions avancées du kit SDK, telles que les demandes simultanées et le traitement par lots. Consultez les objets de commande dans le guide de la AWS SDK for PHP version 3 pour plus de détails.

Un gestionnaire est une fonction qui transforme une commande et une requête en un résultat. Il envoie généralement des requêtes HTTP. Les gestionnaires peuvent comporter des intergiciels, qui renforcent leur comportement. Un gestionnaire est une fonction qui accepte un Aws\CommandInterface et un Psr\Http\Message\RequestInterface, et renvoie une promesse exécutée avec un Aws\ResultInterface ou rejetée avec une raison Aws\Exception\AwsException.

JMESPath est un langage de requête spécifique aux données JSON. Le kit AWS SDK for PHP utilise les expressions JMESPath pour interroger les structures de données PHP. Les expressions JMESPath peuvent être utilisées directement sur les objets Aws\Result et Aws\ResultPaginator via la méthode search($expression).

Un intergiciel est un type spécial de fonction de haut niveau qui augmente le comportement de transfert d'une commande et délègue la tâche à un gestionnaire « suivant ». Les fonctions d'intergiciel acceptent un Aws\CommandInterface et un Psr\Http\Message\RequestInterface, et renvoient une promesse exécutée avec un Aws\ResultInterface ou rejetée avec une raison Aws\Exception\AwsException.

Fait référence à une opération unique au sein de l'API d'un service (par exemple, CreateTable pour DynamoDB, RunInstances pour Amazon EC2). Dans le kit SDK, les opérations sont exécutées en appelant une méthode du même nom sur l'objet client du service correspondant. L'exécution d'une opération implique de préparer et d'envoyer une demande HTTP au service, puis d'en analyser la réponse. Ce processus d’exécution d’une opération est extrait par le kit SDK via les objets de commande.

Certaines opérations AWS de service sont paginées et génèrent des résultats tronqués. Par exemple, le ListObjects fonctionnement d'Amazon S3 ne renvoie que 1 000 objets à la fois. Les opérations telles que celles-ci nécessitent d’effectuer les demandes suivantes avec des paramètres de jeton (ou marqueur) pour récupérer l’ensemble des résultats. Les programmes de pagination sont une fonction du kit SDK qui agissent comme une abstraction de ce processus afin de faciliter l’utilisation des API paginées pour les développeurs. Ils sont accessibles via la méthode getPaginator() du client. Consultez les paginateurs dans le guide de la AWS SDK for PHP version 3 pour plus de détails.

Une promesse représente le résultat final d'une opération asynchrone. Le principal moyen d'interagir avec une promesse réside dans l'utilisation de sa méthode then, qui enregistre les rappels pour recevoir la valeur finale d'une promesse ou la raison pour laquelle la promesse ne peut pas être exécutée.

Les services sont pris en charge dans une ou plusieurs régions géographiques. Les services peuvent avoir différents points de terminaison/différentes URL dans chaque région afin de réduire la latence des données dans vos applications. Fournissez une région lors de la configuration d'un objet client, pour permettre au kit SDK de déterminer le point de terminaison à utiliser avec le service.

Le terme « SDK » peut désigner la bibliothèque du kit AWS SDK for PHP dans son ensemble, mais également la classe Aws\Sdk (documents), qui agit comme une fabrique pour les objets clients de chaque service. La classe Sdk vous permet également de fournir un ensemble de valeurs de configuration globale appliquées à tous les objets clients qu'elle crée.

Méthode générale pour faire référence à l'un AWS des services (Amazon S3, Amazon DynamoDB AWSOpsWorks, etc.). Chaque service est associé, dans le kit SDK, à un objet client prenant en charge une ou plusieurs versions d’API. Chaque service dispose également d’une ou de plusieurs opérations qui composent son API. Les services sont pris en charge dans une ou plusieurs régions.

Lors de l'exécution d'opérations, le kit SDK utilise vos informations d'identification pour créer une signature numérique de votre demande. Le service vérifie ensuite la signature avant de traiter votre demande. Le processus de signature est encapsulé par le kit SDK et s'effectue automatiquement à l'aide des informations d'identification configurées pour le client.

Les programmes d’attente sont une fonction du kit SDK permettant de faciliter l’utilisation des opérations modifiant l’état d’une ressource. Ces programmes sont cohérents à terme ou de nature asynchrone. Par exemple, l'CreateTableopération Amazon DynamoDB renvoie une réponse immédiatement, mais il se peut que la table ne soit pas prête à être consultée pendant plusieurs secondes. L'exécution d'un programme d'attente vous permet d'attendre qu'une ressource passe à un état spécifique en mettant en veille et en interrogeant l'état de la ressource. Les programmes d'attente sont accessibles via la méthode waitUntil() du client. Consultez le guide Waiters in the AWS SDK for PHP Version 3 pour plus de détails.