Paginierungsergebnisse

Auf dieser Seite wird beschrieben, wie verschiedene Cloud Storage-Tools und -Bibliotheken Ergebnisse paginieren. 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 Paginierung standardmäßig aus. 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 zu ListObjects().

C#

Go

Java

Clientbibliotheken führen Paginierung standardmäßig aus. 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

PHP

Python

Ruby

REST APIs

JSON API

Wenn Sie eine Funktion aufrufen, die die Paginierung unterstützt, wird das Fortsetzungstoken nextPageToken in der Antwort zurückgegeben, solange 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, wird die nächste Ergebnisseite zurückgegeben, beginnend nach dem letzten Ergebnis.

Angenommen, Ihre Anfrage zum Auflisten von Objekten in einem Bucket mit dem Namen my-bucket enthält in der Antwort ein nextPageToken:

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

Die HTTP-Anfrage, die Sie verwenden würden, um die Auflistung von Objekten in my-bucket fortzusetzen, wäre die folgende:

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

Weitere Informationen zu den Paginierungsergebnissen finden Sie in der JSON-Referenzdokumentation zu 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, wird die nächste Ergebnisseite nach dem letzten Ergebnis beginnend zurückgegeben.

Angenommen, Ihre Anfrage zum Auflisten von Objekten in einem Bucket mit dem Namen my-bucket enthält in der Antwort ein 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, die Sie zum Auflisten von Objekten in my-bucket verwenden würden, enthält:

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 zu List Objects.