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 one-to-one aux opérations de service. 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 pour 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.

JMESPathest un langage de requête pour les données de type JSON. AWS SDK pour PHP Utilise des JMESPath expressions pour interroger les structures de données PHP. JMESPath les expressions peuvent être utilisées directement sur Aws\Result des Aws\ResultPaginator objets via la search($expression) méthode.

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 seule opération 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 donnent des résultats tronqués. Par exemple, l'ListObjectsopération d'Amazon S3 ne renvoie que 1 000 objets à la fois. De telles opérations nécessitent d'effectuer des requêtes ultérieures avec des paramètres de jeton (ou de marqueur) pour récupérer l'ensemble complet des résultats. Les paginateurs sont une fonctionnalité du SDK qui agit comme une abstraction de ce processus afin de faciliter l'utilisation de la pagination par les développeurs. APIs Ils sont accessibles via la méthode getPaginator() du client. Consultez les paginateurs dans le guide de la AWS SDK pour 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 des points de terminaison différents URLs dans chaque région, qui existent pour 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 faire référence à la AWS SDK pour PHP bibliothèque dans son ensemble, mais également à la Aws\Sdk classe (docs), qui agit comme une fabrique pour les objets clients pour 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.

Une manière générale de faire référence à l'un des AWS services (par exemple, Amazon S3, Amazon DynamoDB AWS OpsWorks, 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'opération Amazon CreateTable DynamoDB renvoie immédiatement une réponse, mais il se peut que la table ne soit pas prête à être consultée avant 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 pour PHP Version 3 pour plus de détails.