Glossar

Services verfügen über eine oder mehrere API-Versionen. Welche Version Sie verwenden, schreibt vor, welche Vorgänge und Parameter gültig sind. API-Versionen sind wie ein Datum formatiert. Die neueste API-Version für Amazon S3 ist beispielsweise2006-03-01. Geben Sie eine Version an, wenn Sie ein Client-Objekt konfigurieren.

Client-Objekte werden verwendet, um Operationen für einen Service auszuführen. Jeder im SDK unterstützte Service verfügt über ein entsprechendes Clientobjekt. Client-Objekte haben Methoden, die den Dienstvorgängen entsprechen. ne-to-one Weitere Informationen zum Erstellen und Verwenden von Clientobjekten finden Sie in der grundlegenden Benutzerführung.

Befehlsobjekte kapseln die Ausführung einer Operation ein. Wenn Sie dem grundlegenden Nutzungsmuster des SDK folgen, werden Sie nicht direkt mit Befehlsobjekten arbeiten. Auf Befehlsobjekte kann mit der MethodegetCommand() eines Clients zugegriffen werden, um erweiterte Funktionen des SDK zu verwenden, z. B. gleichzeitige Anfragen und Stapelverarbeitung. Weitere Informationen finden Sie in den Befehlsobjekten im Handbuch zu AWS SDK for PHP Version 3.

Ein Handler ist eine Funktion, die die eigentliche Transformation eines Befehls und einer Anfrage in ein Ergebnis durchführt. Ein Handler sendet typischerweise HTTP-Anfragen. Handler können mit Middleware konstruiert werden, um ihr Verhalten zu verbessern. Ein Handler ist eine Funktion, die eine Aws\CommandInterfaceund einePsr\Http\Message\RequestInterface akzeptiert und ein Promise zurückgibt, das mit einer Aws\ResultInterface erfüllt oder mit einem Aws\Exception\AwsException Grund abgelehnt wird.

JMESPath ist eine Abfragesprache für JSON-ähnliche Daten. Der AWS SDK for PHP verwendet JMESPath-Ausdrücke zum Abfragen von PHP-Datenstrukturen. JMESPath-Ausdrücke können direkt auf Aws\Result- und Aws\ResultPaginator-Objekte über die search($expression)-Methode verwendet werden.

Middleware ist eine spezielle High-Level-Funktion, die das Verhalten bei der Übertragung eines Befehls ergänzt und an einen "nächsten" Handler delegiert. Middleware-Funktionen akzeptieren eine Aws\CommandInterface und eine Psr\Http\Message\RequestInterface und geben ein Promise zurück, das mit einer Aws\ResultInterfaceerfüllt oder mit einem Aws\Exception\AwsException-Grund abgelehnt wird.

Bezieht sich auf eine einzelne Operation innerhalb der API eines Dienstes (z. B. CreateTable für DynamoDB, RunInstances für Amazon EC2). Im SDK werden Operationen ausgeführt, indem eine Methode mit demselben Namen im Clientobjekt des entsprechenden Service aufgerufen wird. Das Ausführen einer Operation umfasst das Vorbereiten und Senden einer HTTP-Anforderung an den Service und das Analysieren der Antwort. Dieser Vorgang zum Ausführen einer Operation wird vom SDK über Befehl Objekte abstrahiert.

Einige AWS Serviceoperationen sind paginiert und antworten mit verkürzten Ergebnissen. Beispielsweise gibt der ListObjects Vorgang von Amazon S3 nur bis zu 1000 Objekte gleichzeitig zurück. Für derartige Operationen sind nachfolgende Anforderungen mit Token (oder Marker)-Parametern erforderlich, um den gesamten Ergebnissatz abzurufen. Paginatoren sind eine Funktion des SDK, die als eine Abstraktion für diesen Prozess agieren, um Entwicklern die Verwendung paginierter APIs zu erleichtern. Sie werden über die getPaginator() -Methode des Client aufgerufen. Weitere Informationen finden Sie in den Paginatoren im Handbuch zu AWS SDK for PHP Version 3.

Ein Promise repräsentiert das Ergebnis einer asynchronen Operation. Der primäre Weg, mit einem Promise zu interagieren, ist eine Methode, die Callbacks registriert, um entweder den möglichen Wert eines Promises zu erhalten oder den Grund, warum das Promise nicht erfüllt werden kann.

Services werden in einer oder mehreren geographischen Regionenunterstützt. Services können unterschiedliche Endpunkte / URLs in jeder Region haben, die vorhanden sind, um die Datenlatenz in Ihren Anwendungen zu reduzieren. Geben Sie eine Region an beim Konfigurieren eines Clientobjekt, damit das SDK bestimmen kann, welcher Endpunkt mit dem Service verwendet werden soll.

Der Begriff "SDK" kann sich auf die AWS SDK for PHP-Bibliothek als Ganzes beziehen, aber auch auf die Aws\Sdk-Klasse (docs), die als Factory für die Client-Objekte der einzelnen Services dient. Mit der Klasse Sdk können Sie auch einen Satz globaler Konfigurationswerte angeben, die auf alle von ihm erstellten Client-Objekte angewendet werden.

Eine allgemeine Art, auf einen der AWS Dienste zu verweisen (z. B. Amazon S3, Amazon DynamoDB AWS OpsWorks usw.). Jeder Service hat ein entsprechendes Client-Objekt im SDK, das eine oder mehrere API-Versionen unterstützt. Jeder Service hat auch eine oder mehrere Operationen, die seine API bilden. Serviceleistungen werden in einer oder mehreren Regionen unterstützt.

Beim Ausführen von Vorgängen verwendet das SDK Ihre Anmeldeinformationen zum Erstellen einer digitalen Signatur Ihrer Anfrage. Der Service überprüft dann die Signatur vor der Verarbeitung Ihrer Anfrage. Der Signierungsprozess wird vom SDK gekapselt und erfolgt automatisch mit den Anmeldeinformationen, die Sie für den Client konfigurieren.

Waiter sind eine Funktion des SDK, die es einfacher macht, mit Operationen zu arbeiten, die den Status einer Ressource ändern und die von Natur aus letztendlich datenkonsistent oder asynchron sind. Beispielsweise sendet die Amazon DynamoDB CreateTable DynamoDB-Operation sofort eine Antwort zurück, aber die Tabelle ist möglicherweise erst nach einigen Sekunden für den Zugriff bereit. Durch Ausführen eines Waiters können Sie warten, bis eine Ressource in einen bestimmten Status übergeht, indem Sie den Status der Ressource ruhen lassen und abrufen. Der Zugriff auf Waiter erfolgt über die MethodewaitUntil() des Clients. Weitere Informationen finden Sie in den Kellnern in der AWS SDK for PHP Version 3-Anleitung.