Paginierungsergebnisse

Auf dieser Seite wird beschrieben, wie Sie mit verschiedenen Cloud Storage-Tools und ‑Bibliotheken Ergebnisse paginieren. Die Paginierung ist beim Auflisten einer großen Zahl von Objekten oder Buckets erforderlich.

Console

Die Google Cloud Console paginiert automatisch Bucket- und Objektlisten auf den Seiten Buckets und Bucket-Details.


Zur Seite "Buckets"

Befehlszeile

Die Google Cloud CLI paginiert automatisch Bucket- und Objektlisten.

Clientbibliotheken

C++

Clientbibliotheken führen standardmäßig die Paginierung durch. Wenn Sie eine Funktion aufrufen, die die Paginierung unterstützt, wird in der Antwort ein Iterator zurückgegeben. Ein Beispiel für die Verwendung dieses Iterators finden Sie in der C++-Referenzdokumentation für ListObjects().

C#

Clientbibliotheken führen standardmäßig die Paginierung durch. Wenn Sie eine Funktion aufrufen, die die Paginierung unterstützt, wird in der Antwort ein Iterator zurückgegeben. Ein Beispiel für die Verwendung dieses Iterators finden Sie in der C#-Referenzdokumentation für ListObjects().

Go

Clientbibliotheken führen standardmäßig die Paginierung durch. Wenn Sie eine Funktion aufrufen, die die Paginierung unterstützt, wird in der Antwort ein Iterator zurückgegeben. Ein Beispiel für die Verwendung dieses Iterators finden Sie in der Go-Referenzdokumentation für Bucket.Objects.

Java

Clientbibliotheken führen standardmäßig die Paginierung durch. Wenn Sie eine Funktion aufrufen, die die Paginierung unterstützt, wird in der Antwort ein Seitentoken zurückgegeben. Ein Beispiel für die Verwendung finden Sie in der Java-Referenzdokumentation.

Node.js

Clientbibliotheken führen standardmäßig die Paginierung durch. Wenn Sie eine Funktion aufrufen, die die Paginierung unterstützt, wird in der Antwort ein Iterator zurückgegeben. Ein Beispiel für die Verwendung dieses Iterators finden Sie in der Node.js-Referenzdokumentation für getFiles().

PHP

Clientbibliotheken führen standardmäßig die Paginierung durch. Wenn Sie eine Funktion aufrufen, die die Paginierung unterstützt, wird in der Antwort ein Iterator zurückgegeben. Ein Beispiel für die Verwendung dieses Iterators finden Sie in der PHP-Referenzdokumentation für Objects.

Python

Clientbibliotheken führen standardmäßig die Paginierung durch. Wenn Sie eine Funktion aufrufen, die die Paginierung unterstützt, wird in der Antwort ein Iterator zurückgegeben. Ein Beispiel für die Verwendung dieses Iterators finden Sie in der Python-Referenzdokumentation für Seiten-Iteratoren.

Ruby

Clientbibliotheken führen standardmäßig die Paginierung durch. Wenn Sie eine Funktion aufrufen, die die Paginierung unterstützt, wird in der Antwort ein Iterator zurückgegeben. Ein Beispiel für die Verwendung dieses Iterators finden Sie in der Ruby-Referenzdokumentation für Google::Cloud::Storage::File::List.

REST APIs

JSON API

Wenn Sie eine Funktion aufrufen, die die Paginierung unterstützt, wird das Fortsetzungstoken nextPageToken in der Antwort zurückgegeben, wenn die Liste unvollständig ist. nextPageToken steht für das letzte zurückgegebene Ergebnis. Wenn Sie den Wert von nextPageToken an den Parameter pageToken einer nachfolgenden Anfrage übergeben, geben Sie die nächste Ergebnisseite zurück, beginnend nach dem letzten Ergebnis.

Angenommen, Ihre Anfrage zum Auflisten von Objekten in einem Bucket namens my-bucket enthält in der Antwort einen nextPageToken:

{
  "kind": "storage#objects",
  "nextPageToken": "CgtzaGliYS0yLmpwZw==",
  "items": [
    {
      OBJECT_1_METADATA
    },
    {
      OBJECT_2_METADATA
    },
    …
  ]
}

Die HTTP-Anfrage, mit der du die Auflistung der Objekte in my-bucket fortsetzen würdest, sieht so aus:

GET https://storage.googleapis.com/storage/v1/b/my-bucket/o?pageToken=CgtzaGliYS0yLmpwZw==

Weitere Informationen zu den Paginierungsergebnissen finden Sie in der JSON-Referenzdokumentation für Objects: list oder Buckets: list.

XML API

Wenn Sie eine Funktion aufrufen, die die Paginierung unterstützt, wird das Fortsetzungstoken NextContinuationToken in der Antwort zurückgegeben, wenn die Liste unvollständig ist. NextContinuationToken steht für das letzte zurückgegebene Ergebnis. Wenn Sie den Wert von NextContinuationToken an den Parameter continuation-token einer nachfolgenden Anfrage übergeben, geben Sie die nächste Ergebnisseite zurück, beginnend nach dem letzten Ergebnis.

Angenommen, Ihre Anfrage zum Auflisten von Objekten in einem Bucket namens my-bucket enthält in der Antwort einen NextContinuationToken:

<?xml version='1.0' encoding='UTF-8'?>
<ListBucketResult xmlns='http://doc.s3.amazonaws.com/2006-03-01'>
  <Name>my-bucket</Name>
  <NextContinuationToken>CgtzaGliYS0yLmpwZw==</NextContinuationToken>
  <KeyCount>2</KeyCount>
  <MaxKeys>2</MaxKeys>
  <IsTruncated>true</IsTruncated>
  <Contents>
    ...
  </Contents>
  ...
</ListBucketResult>

Beachten Sie, dass list-type auf 2 gesetzt werden muss, um beim Auflisten von Objekten einen NextContinuationToken zurückzugeben.

Die HTTP-Anfrage, mit der Sie die Auflistung von Objekten in my-bucket fortsetzen, enthält Folgendes:

GET /?continuation-token=CgtzaGliYS0yLmpwZw==&list-type=2 HTTP/1.1
  Host: my-bucket.storage.googleapis.com

Eine ausführlichere Anleitung zum Paginieren von Ergebnissen aus einem Bucket finden Sie in der XML-Referenzdokumentation für List Objects.

Nächste Schritte