Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
Paginierung
Viele AWS Serviceoperationen können mehr Ergebnisse liefern, als in eine einzige Antwort passen. In diesem Fall enthält die Antwort ein Paginierungstoken, das angibt, dass mehr Ergebnisse verfügbar sind. Um die nächste Ergebnisseite abzurufen, fügen Sie dieses Token in eine nachfolgende Anfrage ein. Dieser Vorgang wird wiederholt, bis kein Token zurückgegeben wird, was bedeutet, dass Sie alle Ergebnisse erhalten haben.
Wie funktioniert die Paginierung
Wenn Sie eine paginierte API-Operation aufrufen, gibt der Dienst eine feste Höchstanzahl von Elementen pro Antwort zurück. Wenn die Gesamtzahl der Elemente dieses Maximum überschreitet, nimmt der Dienst ein Paginierungstoken in die Antwort auf. Der spezifische Name dieses Tokens variiert je nach Dienst. Zu den gebräuchlichen Namen gehörenNextToken,Marker, ContinuationToken und. ExclusiveStartKey Um die nächste Seite anzufordern, übergeben Sie diesen Tokenwert im entsprechenden Anforderungsparameter Ihres nächsten Aufrufs.
Die meisten paginierten Operationen unterstützen auch einen Parameter, der die maximale Anzahl von Elementen steuert, die pro Seite zurückgegeben werden. Zu den gebräuchlichen Bezeichnungen für diesen Parameter gehören MaxResultsMaxItems,MaxKeys,MaxRecords, undLimit.
Ein Paginierungstoken ist nur gültig, wenn Sie es in einer früheren Antwort desselben Vorgangs erhalten haben. Wenn die Antwort kein Token enthält, können keine weiteren Ergebnisse abgerufen werden.
Verwenden von Paginatoren
Anstatt Paginierungstoken manuell zu verfolgen, bieten alle AWS SDKs Paginator-Abstraktionen. Ein Paginator kümmert sich automatisch um die Tokenverwaltung, führt aufeinanderfolgende API-Aufrufe durch und liefert Ergebnisse, bis alle Seiten abgerufen wurden. Die Verwendung eines Paginators vereinfacht Ihren Code und reduziert das Risiko von Fehlern, z. B. wenn Sie vergessen, das Token zu übergeben, oder es falsch verwenden.
Hauptmerkmale von Paginatoren in allen SDKs:
-
Paginatoren akzeptieren dieselben Eingabeparameter wie die zugrunde liegende API-Operation.
-
Paginatoren erkennen automatisch, wenn mehr Seiten verfügbar sind, und rufen sie ab.
-
Paginatoren stellen keine Anfragen mehr, wenn in der Antwort kein Paginierungstoken zurückgegeben wird.
-
Einige SDKs bieten zusätzlich Mechanismen zur Begrenzung der Gesamtzahl der abgerufenen Seiten oder Elemente.
Informationen zur Paginator-Syntax und zu den in Ihrer Sprache verfügbaren Verwendungsmustern finden Sie im Entwicklerhandbuch Ihres jeweiligen SDK.
Support durch AWS SDKs und Tools
Die folgenden SDKs unterstützen die in diesem Thema beschriebenen Funktionen und Einstellungen. Alle teilweisen Ausnahmen werden vermerkt. Alle Einstellungen für JVM-Systemeigenschaften werden AWS SDK for Kotlin nur von AWS SDK für Java und vom unterstützt.
| SDK | Unterstützt | Hinweise oder weitere Informationen |
|---|---|---|
| AWS CLI v2 | Ja | Built-in automatische Paginierung für alle Befehle. Zum Deaktivieren verwenden--no-paginate. |
| SDK for C++ | Nein | Manuelle Token-Behandlung erforderlich. |
| SDK for Go V2 (1.x) | Ja | Verwenden Sie New<OperationName>Paginator Typen. |
| SDK for Go 1.x (V1) | Ja | Verwenden Sie <OperationName>Pages Methoden. |
| SDK for Java 2.x | Ja | Verwenden Sie <operationName>Paginator Methoden auf dem Client. |
| SDK for Java 1.x | Ja | |
| SDK für 3.x JavaScript | Ja | Verwenden Sie paginate<OperationName> Funktionen. |
| SDK für JavaScript 2.x | Nein | Manuelle Token-Behandlung erforderlich. |
| SDK für Kotlin | Ja | Verwenden Sie <operationName>Paginated Erweiterungsfunktionen. |
| SDK for .NET 4.x | Ja | Verwenden Sie IPaginator Schnittstellen. |
| SDK for .NET 3.x | Ja | Verwenden Sie IPaginator Schnittstellen. |
| SDK for PHP 3.x | Ja | getPaginatorAuf dem Client verwenden. |
| SDK for Python (Boto3) | Ja | get_paginatorAuf dem Client verwenden. |
| SDK for Ruby 3.x | Ja | Wird für Antworten verwendet.each, die Paginierung unterstützen. |
| SDK für Rust | Ja | Verwenden Sie .into_paginator() auf Anfrage Builder. |
| SDK für Swift | Ja | Verwenden Sie PaginatedSequence Typen. |
| Tools für PowerShell V5 | Ja | Built-in automatische Paginierung. Zum Deaktivieren verwenden-NoAutoIteration. |
| Tools für PowerShell V4 | Ja |
