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().

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 jeton de page est renvoyé dans la réponse. Pour obtenir un exemple d'utilisation, consultez la documentation de référence Java.

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.

Par exemple, supposons que votre requête de liste d'objets dans un bucket nommé my-bucket contienne un nextPageToken dans la réponse:

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

La requête HTTP que vous utiliseriez pour continuer à lister des objets dans my-bucket serait la suivante:

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

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.

Par exemple, supposons que votre requête de liste d'objets dans un bucket nommé my-bucket contienne un NextContinuationToken dans la réponse:

<?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>

Notez que list-type doit être défini sur 2 pour renvoyer un objet NextContinuationToken lors de la liste des objets.

La requête HTTP que vous utiliseriez pour continuer à lister des objets dans my-bucket inclurait les éléments suivants:

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

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