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.
# Verwenden der Paginierungsoptionen in AWS CLI
In diesem Thema werden die verschiedenen Möglichkeiten beschrieben, die Ausgabe von AWS Command Line Interface ()AWS CLI zu paginieren.
Es gibt hauptsächlich zwei Möglichkeiten, die Paginierung vom AWS CLI aus zu steuern.
+ [Verwenden von serverseitigen Paginierungsparametern.](#cli-usage-pagination-serverside)
+ [Verwenden des standardmäßigen clientseitigen Auslagerungsprogramms für die Ausgabe](#cli-usage-pagination-clientside).
Serverseitige Paginierungsparameter werden zuerst verarbeitet und jede Ausgabe wird an die clientseitige Paginierung gesendet.
## Serverseitige Paginierung
Bei den meisten Befehlen, die eine umfangreiche Liste von Elementen zurückgeben, stehen mehrere serverseitige Optionen zur Verfügung, mit denen die Anzahl der in der Ausgabe enthaltenen Elemente gesteuert werden kann, wenn die AWS CLI API eines Dienstes zum Auffüllen der Liste aufgerufen wird. AWS CLI Die serverseitige Paginierung in der AWS CLI wird von der AWS Service-API aktiviert, daher funktionieren diese Optionen nur, wenn die Service-API sie aktiviert.
**Topics**
+ [--no-paginate](#cli-usage-pagination-nopaginate)
+ [--page-size](#cli-usage-pagination-pagesize)
+ [--max-items](#cli-usage-pagination-maxitems)
+ [--starting-token](#cli-usage-pagination-startingtoken)
Standardmäßig AWS CLI verwendet der eine Seitengröße, die vom jeweiligen Dienst bestimmt wird, und ruft alle verfügbaren Elemente ab. Amazon S3 hat beispielsweise eine Standardseitengröße von 1 000. Wenn Sie `aws s3api list-objects` auf einem Amazon-S3-Bucket ausführen, der 3 500 Objekte enthält, ruft die AWS CLI Amazon S3 automatisch vier Mal auf, verarbeitet die servicespezifische Paginierungslogik für Sie im Hintergrund und gibt alle 3 500 Objekte in der endgültigen Ausgabe zurück.
Informationen darüber, ob für einen bestimmten Befehl serverseitige Paginierung verfügbar ist, finden Sie im [Version 2.](https://docs.aws.amazon.com/cli/latest/reference/index.html)
### So verwenden Sie den --no-paginate-Parameter
Die `--no-paginate`-Option deaktiviert folgende Paginierungs-Token auf der Client-Seite. Wenn Sie einen Befehl verwenden, führt der standardmäßig AWS CLI automatisch mehrere Aufrufe durch, um alle möglichen Ergebnisse zurückzugeben, um die Paginierung zu erstellen. Ein Aufruf für jede Seite. Beim Deaktivieren der Paginierung wird die erste Seite mit Befehlsergebnissen AWS CLI nur einmal aufgerufen.
Wenn Sie beispielsweise einen `aws s3api list-objects` Amazon S3-Bucket verwenden, der 3.500 Objekte enthält, ruft der Amazon S3 AWS CLI nur zum ersten Mal auf und gibt in der endgültigen Ausgabe nur die ersten 1.000 Objekte zurück.
```
$ aws s3api list-objects \
--bucket amzn-s3-demo-bucket \
--no-paginate
{
"Contents": [
...
```
### So verwenden Sie den –page-size-Parameter
Wenn beim Ausführen von Listenbefehlen für eine große Anzahl von Ressourcen Probleme auftreten, ist die Standardseitengröße möglicherweise zu hoch. Dies kann dazu führen, dass Aufrufe von AWS Diensten die maximal zulässige Zeit überschreiten und zu einem „Timeout“ -Fehler führen. Sie können die `--page-size` Option verwenden, um anzugeben, dass bei jedem Aufruf des AWS Dienstes eine geringere Anzahl von Elementen AWS CLI angefordert wird. Der ruft AWS CLI immer noch die vollständige Liste ab, führt jedoch eine größere Anzahl von Dienst-API-Aufrufen im Hintergrund aus und ruft bei jedem Aufruf eine kleinere Anzahl von Elementen ab. Dadurch ist es wahrscheinlicher, dass Aufrufe nicht zu einem Zeitüberschreitungsfehler führen. Das Ändern der Seitengröße hat keine Auswirkungen auf die Ausgabe. Es wirkt sich nur auf die Anzahl der API-Aufrufe aus, die erforderlich sind, um die Ausgabe zu generieren.
```
$ aws s3api list-objects \
--bucket amzn-s3-demo-bucket \
--page-size 100
{
"Contents": [
...
```
### So verwenden Sie den –max-items-Parameter
Verwenden Sie die Option, um weniger Elemente gleichzeitig in die AWS CLI Ausgabe aufzunehmen. `--max-items` Der verarbeitet die Seitennummerierung mit dem Service AWS CLI weiterhin wie zuvor beschrieben, druckt aber nur die Anzahl der Elemente gleichzeitig aus, die Sie angeben.
```
$ aws s3api list-objects \
--bucket amzn-s3-demo-bucket \
--max-items 100
{
"NextToken": "eyJNYXJrZXIiOiBudWxsLCAiYm90b190cnVuY2F0ZV9hbW91bnQiOiAxfQ==",
"Contents": [
...
```
### So verwenden Sie den –starting-token-Parameter
Wenn die Anzahl der ausgegebenen Elemente (`--max-items`) geringer als die Gesamtanzahl der Elemente ist, die von den zugrunde liegenden API-Aufrufen zurückgeliefert werden, enthält die Ausgabe ein `NextToken`. Dieses können Sie in einem anschließenden Befehl zum Abrufen der nächsten Gruppe von Elementen übergeben. Im folgenden Beispiel wird gezeigt, wie Sie den Wert `NextToken` aus dem vorherigen Beispiel verwenden und die zweiten hundert Elemente abrufen.
**Anmerkung**
Der Parameter `--starting-token` kann nicht null oder leer sein. Wenn der vorherige Befehl keinen `NextToken`-Wert zurückgibt, können keine weiteren Elemente zurückgegeben werden und Sie müssen den Befehl nicht erneut aufrufen.
```
$ aws s3api list-objects \
--bucket amzn-s3-demo-bucket \
--max-items 100 \
--starting-token eyJNYXJrZXIiOiBudWxsLCAiYm90b190cnVuY2F0ZV9hbW91bnQiOiAxfQ==
{
"Contents": [
...
```
Der angegebene AWS Dienst gibt möglicherweise nicht bei jedem Aufruf Elemente in derselben Reihenfolge zurück. Wenn Sie verschiedene Werte für `--page-size` und `--max-items` angeben, können Sie unerwartete Ergebnisse mit fehlenden oder doppelten Elementen bekommen. Um dies zu verhindern, verwenden Sie dieselbe Zahl für `--page-size` und `--max-items`, um die Paginierung der AWS CLI mit der Paginierung der zugrunde liegenden Services zu synchronisieren. Sie können auch die gesamte Liste abrufen und erforderliche Paginierungsvorgänge lokal durchführen.
## Clientseitiger Pager
AWS CLI Version 2 bietet die Verwendung eines clientseitigen Pager-Programms für die Ausgabe. Standardmäßig gibt dieses Feature alle Ausgaben über das Standard-Pager-Programm Ihres Betriebssystems zurück.
In der Reihenfolge der Rangfolge können Sie den Ausgabe-Pager wie folgt angeben:
+ Verwenden der Einstellung `cli_pager` in der Datei `config` im `default` oder einem benannten Profil.
+ Über die `AWS_PAGER` Umgebungsvariable.
+ Über die `PAGER` Umgebungsvariable.
In der Rangfolge können Sie die Verwendung eines externen Paging-Programms auf folgende Weise deaktivieren:
+ Verwenden Sie die `--no-cli-pager`-Befehlszeilenoption, um den Pager für eine einzelne Befehlsverwendung zu deaktivieren.
+ Setzen Sie die Einstellung `cli_pager` oder Variable `AWS_PAGER` auf eine leere Zeichenfolge.
**Topics**
+ [cli\$1pager](#cli-usage-pagination-clipager)
+ [AWS\$1PAGER](#cli-usage-pagination-awspager)
+ [--no-cli-pager](#cli-usage-pagination-noclipager)
+ [Pager-Flags](#cli-usage-pagination-flags)
### So verwenden Sie die cli\$1pager-Einstellung
Sie können Ihre häufig verwendeten Konfigurationseinstellungen und Anmeldeinformationen in Dateien speichern, die von der AWS CLI verwaltet werden. Einstellungen in einem Namensprofil haben Vorrang vor den Einstellungen im `default`-Profil. Weitere Informationen zu den verschiedenen Konfigurationseinstellungen finden Sie unter [Einstellungen für die Konfiguration und die Anmeldeinformationsdatei in der AWS CLI](cli-configure-files.md).
Im folgenden Beispiel wird der Standard-Ausgabe-Pager auf das `less`-Programm eingestellt.
```
[default]
cli_pager=less
```
Im folgenden Beispiel wird die Standardeinstellung zur Deaktivierung der Verwendung eines Pagers festgelegt.
```
[default]
cli_pager=
```
### Wie legt man die Umgebungsvariable fest AWS\$1PAGER
Im folgenden Beispiel wird der Standard-Ausgabe-Pager auf das `less`-Programm eingestellt. Weitere Informationen zu Umgebungsvariablen finden Sie unter [Konfiguration von Umgebungsvariablen für AWS CLI](cli-configure-envvars.md).
------
#### [ Linux and macOS ]
```
$ export AWS_PAGER="less"
```
------
#### [ Windows ]
```
C:\> setx AWS_PAGER "less"
```
------
### Wie benutzt man die no-cli-pager Option --
Um die Verwendung eines Pagers für einen einzelnen Befehl zu deaktivieren, verwenden Sie die Option `--no-cli-pager`. Weitere Informationen zu diesen Befehlszeilenoptionen finden Sie unter [Befehlszeilenoptionen in der AWS CLI](cli-configure-options.md).
```
$ aws s3api list-objects \
--bucket amzn-s3-demo-bucket \
--no-cli-pager
{
"Contents": [
...
```
### So verwenden Sie Pager-Flags
Sie können Flags angeben, die automatisch mit Ihrem Paging-Programm verwendet werden sollen. Flags sind abhängig von dem Paging-Programm, das Sie verwenden. Die folgenden Beispiele beziehen sich auf die typischen Standardwerte von `less` und `more`.
------
#### [ Linux and macOS ]
Wenn Sie nichts anderes angeben, verwendet die AWS CLI Pager-Version 2 standardmäßig ist`less`. Wenn Sie die `LESS` Umgebungsvariable nicht gesetzt haben, verwendet AWS CLI Version 2 die `FRX` Flags. Sie können Flags kombinieren, indem Sie sie bei der Einstellung des AWS CLI Pagers angeben.
Im folgenden Beispiel wird die `S`-Flag verwendet. Dieses Flag wird dann mit den Standard-Flags `FRX` kombiniert, um ein endgültiges Flag `FRXS` zu erstellen.
```
$ export AWS_PAGER="less -S"
```
Wenn Sie keines der Flags `FRX` möchten, können Sie sie negieren. Im folgenden Beispiel wird das `F`-Flag negiert, um ein endgültiges `RX`-Flag zu erstellen.
```
$ export AWS_PAGER="less -+F"
```
Weitere Informationen zu `less`-Flags finden Sie unter [weniger](http://manpages.org/less/1#options) unter *manpages.org*.
------
#### [ Windows ]
Wenn Sie nichts anderes angeben, enthält der Pager, den AWS CLI Version 2 standardmäßig verwendet, keine zusätzlichen `more` Flags.
Im folgenden Beispiel wird der Parameter `/c` genutzt.
```
C:\> setx AWS_PAGER "more /c"
```
Weitere Informationen zu `more`-Flags finden Sie unter `[more](https://docs.microsoft.com/en-us/windows-server/administration/windows-commands/more)` auf *Microsoft Docs*.
------