Paginare i risultati

C++

Le librerie client eseguono la paginazione per impostazione predefinita. Quando chiami una funzione che supporta la paginazione, nella risposta viene restituito un iteratore. Per un esempio di come viene utilizzato questo iteratore, consulta la documentazione di riferimento di C++ per ListObjects().

C#

Le librerie client eseguono la paginazione per impostazione predefinita. Quando chiami una funzione che supporta la paginazione, nella risposta viene restituito un iteratore. Per un esempio di come viene utilizzato questo iteratore, consulta la documentazione di riferimento di C# per ListObjects().

Vai

Le librerie client eseguono la paginazione per impostazione predefinita. Quando chiami una funzione che supporta la paginazione, nella risposta viene restituito un iteratore. Per un esempio di come viene utilizzato questo iteratore, consulta la documentazione di riferimento di Go per Bucket.Objects.

Java

Le librerie client eseguono la paginazione per impostazione predefinita. Quando chiami una funzione che supporta la paginazione, nella risposta viene restituito un token di pagina. Per un esempio di come viene utilizzato, consulta la documentazione di riferimento di Java.

Node.js

Le librerie client eseguono la paginazione per impostazione predefinita. Quando chiami una funzione che supporta la paginazione, nella risposta viene restituito un iteratore. Per un esempio di come viene utilizzato questo iteratore, consulta la documentazione di riferimento di Node.js per getFiles().

PHP

Le librerie client eseguono la paginazione per impostazione predefinita. Quando chiami una funzione che supporta la paginazione, nella risposta viene restituito un iteratore. Per un esempio di come viene utilizzato questo iteratore, consulta la documentazione di riferimento di PHP per Objects.

Python

Le librerie client eseguono la paginazione per impostazione predefinita. Quando chiami una funzione che supporta la paginazione, nella risposta viene restituito un iteratore. Per un esempio di come viene utilizzato questo iteratore, consulta la documentazione di riferimento di Python per gli iteratori di pagine.

Ruby

Le librerie client eseguono la paginazione per impostazione predefinita. Quando chiami una funzione che supporta la paginazione, nella risposta viene restituito un iteratore. Per un esempio di come viene utilizzato questo iteratore, consulta la documentazione di riferimento di Ruby per Google::Cloud::Storage::File::List.

API JSON

Quando chiami una funzione che supporta l'impaginazione, il token di continuazione nextPageToken viene restituito nella risposta se l'elenco è incompleto. nextPageToken rappresenta l'ultimo risultato restituito. Quando passi il valore di nextPageToken al parametro pageToken di una richiesta successiva, restituisci la pagina successiva dei risultati, a partire dall'ultimo risultato.

Ad esempio, supponiamo che la tua richiesta di elencare gli oggetti in un bucket denominato my-bucket contenga un nextPageToken nella risposta:

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

La richiesta HTTP che utilizzeresti per continuare a elencare gli oggetti in my-bucket sarebbe la seguente:

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

Per ulteriori informazioni sulla paginazione dei risultati, consulta la documentazione di riferimento JSON per Objects: list o Buckets: list.

API XML

Quando chiami una funzione che supporta la paginazione, il token di continuazione NextContinuationToken viene restituito nella risposta se l'elenco è incompleto. Il NextContinuationToken rappresenta l'ultimo risultato restituito. Quando passi il valore di NextContinuationToken al parametro continuation-token di una richiesta successiva, restituisci la pagina successiva dei risultati, a partire dall'ultimo risultato.

Ad esempio, supponiamo che la tua richiesta di elencare gli oggetti in un bucket denominato my-bucket contenga un NextContinuationToken nella risposta:

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

Tieni presente che list-type deve essere impostato su 2 per restituire un NextContinuationToken quando vengono elencati gli oggetti.

La richiesta HTTP che utilizzeresti per continuare a elencare gli oggetti in my-bucket includerebbe quanto segue:

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

Per istruzioni più dettagliate sulla paginazione dei risultati di un bucket, consulta la documentazione di riferimento XML per List Objects.