Paginierungsergebnisse

Auf dieser Seite wird beschrieben, wie verschiedene 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 Iterator zurückgegeben. Ein Beispiel für die Verwendung dieses Iterators finden Sie in der Java-Referenzdokumentation für Storage.Objects.list.

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.

Beispielantwort

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

Weitere Informationen zu objects Resource finden Sie in der Objektreferenzdokumentation.

Beispielanfrage

GET https://storage.googleapis.com/storage/v1/b/BUCKET_NAME&pageToken=NEXT_PAGE_TOKEN HTTP/1.1

Authorization: Bearer ACCESS_TOKEN
Accept: application/json

Dabei gilt:

  • NEXT_PAGE_TOKEN ist der Wert nextPageToken aus der vorherigen Antwort.
  • BUCKET_NAME ist der Name Ihres Storage-Buckets.
  • ACCESS_TOKEN ist das Zugriffstoken, das Sie von OAuth 2.0 Playground erhalten.

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, wird die nächste Ergebnisseite beginnend mit dem letzten Ergebnis zurückgegeben.

Beispielantwort

HTTP/1.1 200 OK
X-goog-metageneration: 5
Content-location: https://example-bucket.storage.googleapis.com?max-keys=2&list-type=2
Expires: Wed, 02 Mar 2022 15:58:11 GMT
Content-length: 781
X-guploader-uploadid: ADPycdvFss2qs9wyMrrM2fIIZzTFFnZZM9i9k8TMbHipsxz8PqUjS5Xh_4tLsvb3_YYHTT0HmSYVv1Gtr816HQFnk28HMglyWA
Cache-control: private, max-age=0
Date: Wed, 02 Mar 2022 15:58:11 GMT
Content-type: application/xml; charset=UTF-8

<?xml version='1.0' encoding='UTF-8'?>
<ListBucketResult xmlns='http://doc.s3.amazonaws.com/2006-03-01'>
  <Name>example_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 einen NextContinuationToken zurückzugeben.

Beispielanfrage

GET /?continuation-token=NEXT_CONTINUATION_TOKEN&prefix=t&marker=test&list-type=2 HTTP/1.1 \
  Host: BUCKET_NAME.storage.googleapis.com
  Date: Wed, 02 Mar 2022 16:00:00 GMT
  Content-Length: 0
  Authorization: AUTHENTICATION_STRING

Dabei gilt:

  • NEXT_CONTINUATION_TOKEN ist der Wert NextContinuationToken, den Sie von der vorherigen Antwort erhalten.
  • BUCKET_NAME ist der Name Ihres Storage-Buckets.
  • AUTHENTICATION_STRING ist das Zugriffstoken, das Sie von OAuth 2.0 Playground erhalten.

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

Nächste Schritte