

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 von paginierten Ergebnissen im AWS SDK for Ruby

Viele AWS Operationen geben gekürzte Ergebnisse zurück, wenn die Nutzlast zu groß ist, um sie in einer einzigen Antwort zurückzugeben. Stattdessen gibt der Dienst einen Teil der Daten und ein Token zurück, um den nächsten Satz von Elementen abzurufen. Dieses Muster wird als Paginierung bezeichnet. 

## Seitenbezogene Antworten sind aufzählbar
<a name="aws-ruby-sdk-paged-response-enumerable"></a>

Die einfachste Methode zum Verarbeiten von Seiten mit Antwortdaten ist die Verwendung des integrierten Enumerators im Antwortobjekt, wie im folgenden Beispiel gezeigt.

```ruby
s3 = Aws::S3::Client.new

s3.list_objects(bucket:'aws-sdk').each do |response|
  puts response.contents.map(&:key)
end
```

Dies ergibt ein Antwortobjekt pro ausgeführtem API-Aufruf und zählt Objekte in dem benannten Bucket auf. Das SDK ruft zusätzliche Seiten von Daten ab, um die Anforderung abzuschließen.

## Manuelles Verarbeiten von Antworten auf Seiten
<a name="aws-ruby-sdk-handling-paged-response-handling"></a>

Wenn Sie das Blättern selbst verarbeiten möchten, verwenden Sie die `next_page?`-Methode, um zu bestätigen, dass mehr Seiten zum Abrufen vorhanden sind. Alternativ können Sie mit der `last_page?`-Methode überprüfen, ob keine weiteren Seiten zum Abrufen verfügbar sind.

Wenn es mehr Seiten gibt, verwenden Sie die `next_page`-Methode (`?` ist nicht vorhanden), um die nächste Ergebnisseite abzurufen, wie im folgenden Beispiel veranschaulicht.

```ruby
s3 = Aws::S3::Client.new

# Get the first page of data
response = s3.list_objects(bucket:'aws-sdk')

# Get additional pages
while response.next_page? do
  response = response.next_page
  # Use the response data here...
end
```

**Anmerkung**  
Wenn Sie die `next_page` Methode aufrufen und keine Seiten mehr abgerufen werden können, löst das SDK eine [Aws:::PageableResponse: LastPageError](https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/PageableResponse/LastPageError.html) Exception aus.

## Klassen für ausgelagerte Daten
<a name="aws-ruby-sdk-paged-data-classes"></a>

Seitenbezogene Daten im AWS SDK for Ruby werden von der PageableResponse Klasse [Aws::](https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/PageableResponse.html) verarbeitet, die in [Seahorse: :Client: :Response enthalten ist, um Zugriff auf ausgelagerte Daten zu ermöglichen](https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Seahorse/Client/Response.html).