Paginer les résultats

Cette page décrit comment différents outils et bibliothèques Cloud Storage paginent les résultats. La pagination est requise pour répertorier un grand nombre d'objets ou de buckets.

Console

La console Google Cloud pagine automatiquement les listes de buckets et d'objets sur les pages Buckets et Détails du bucket.


Ouvrir la page "Buckets"

Ligne de commande

Google Cloud CLI pagine automatiquement les listes de buckets et d'objets.

Bibliothèques clientes

C++

Les bibliothèques clientes effectuent la pagination par défaut. Lorsque vous appelez une fonction compatible avec la pagination, un itérateur est renvoyé dans la réponse. Pour obtenir un exemple d'utilisation de cet itérateur, consultez la documentation de référence sur C++ pour ListObjects().

C#

Les bibliothèques clientes effectuent la pagination par défaut. Lorsque vous appelez une fonction compatible avec la pagination, un itérateur est renvoyé dans la réponse. Pour obtenir un exemple d'utilisation de cet itérateur, consultez la documentation de référence sur C# pour ListObjects().

Go

Les bibliothèques clientes effectuent la pagination par défaut. Lorsque vous appelez une fonction compatible avec la pagination, un itérateur est renvoyé dans la réponse. Pour obtenir un exemple d'utilisation de cet itérateur, consultez la documentation de référence sur Go pour Bucket.Objects.

Java

Les bibliothèques clientes effectuent la pagination par défaut. Lorsque vous appelez une fonction compatible avec la pagination, un itérateur est renvoyé dans la réponse. Pour obtenir un exemple d'utilisation de cet itérateur, consultez la documentation de référence sur Java pour Storage.Objects.list.

Node.js

Les bibliothèques clientes effectuent la pagination par défaut. Lorsque vous appelez une fonction compatible avec la pagination, un itérateur est renvoyé dans la réponse. Pour obtenir un exemple d'utilisation de cet itérateur, consultez la documentation de référence sur Node.js pour getFiles().

PHP

Les bibliothèques clientes effectuent la pagination par défaut. Lorsque vous appelez une fonction compatible avec la pagination, un itérateur est renvoyé dans la réponse. Pour obtenir un exemple d'utilisation de cet itérateur, consultez la documentation de référence sur PHP pour Objects.

Python

Les bibliothèques clientes effectuent la pagination par défaut. Lorsque vous appelez une fonction compatible avec la pagination, un itérateur est renvoyé dans la réponse. Pour obtenir un exemple d'utilisation de cet itérateur, consultez la documentation de référence sur Python pour les itérateurs de page.

Ruby

Les bibliothèques clientes effectuent la pagination par défaut. Lorsque vous appelez une fonction compatible avec la pagination, un itérateur est renvoyé dans la réponse. Pour obtenir un exemple d'utilisation de cet itérateur, consultez la documentation de référence sur Ruby pour Google::Cloud::Storage::File::List.

API REST

API JSON

Lorsque vous appelez une fonction compatible avec la pagination, le jeton de continuité nextPageToken est renvoyé dans la réponse si la liste est incomplète. nextPageToken représente le dernier résultat renvoyé. Lorsque vous transmettez la valeur de nextPageToken au paramètre pageToken d'une requête ultérieure, vous renvoyez la page de résultats suivante, en commençant après le dernier résultat.

Exemple de réponse

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

Pour en savoir plus sur objects Resource, consultez la documentation de référence sur les objets.

Exemple de requête

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

Authorization: Bearer ACCESS_TOKEN
Accept: application/json

Où :

  • NEXT_PAGE_TOKEN est la valeur nextPageToken de la réponse précédente.
  • BUCKET_NAME est le nom du bucket de stockage.
  • ACCESS_TOKEN est le jeton d'accès que vous recevez de OAuth 2.0 Playground.

Pour en savoir plus sur la pagination des résultats, consultez la documentation de référence sur JSON pour Objects: list ou Buckets: list.

API XML

Lorsque vous appelez une fonction compatible avec la pagination, le jeton de continuité NextContinuationToken est renvoyé dans la réponse si la liste est incomplète. NextContinuationToken représente le dernier résultat renvoyé. Lorsque vous transmettez la valeur de NextContinuationToken au paramètre continuation-token d'une requête ultérieure, vous renvoyez la page de résultats suivante, en commençant après le dernier résultat.

Exemple de réponse

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>

Notez que list-type doit être défini sur 2 pour renvoyer un objet NextContinuationToken.

Exemple de requête

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

Où :

  • NEXT_CONTINUATION_TOKEN est la valeur NextContinuationToken que vous recevez de la réponse précédente.
  • BUCKET_NAME est le nom du bucket de stockage.
  • AUTHENTICATION_STRING est le jeton d'accès que vous recevez de OAuth 2.0 Playground.

Pour obtenir des instructions plus détaillées sur la pagination des résultats d'un bucket, consultez la documentation de référence sur XML pour List Objects.

Étapes suivantes