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.
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()
.
Accéder
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
.