Paginare i risultati

Questa pagina descrive in che modo diversi strumenti e librerie Cloud Storage paginano i risultati. La paginazione è obbligatoria quando viene elencato un numero elevato di oggetti o bucket.

Console

La console Google Cloud esegue automaticamente la paginazione degli elenchi di bucket e oggetti nelle pagine Bucket e Dettagli bucket.


Apri la pagina Bucket

Riga di comando

L'interfaccia a riga di comando Google Cloud esegue automaticamente la paginazione degli elenchi di bucket e oggetti.

Librerie client

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

API JSON

Quando chiami una funzione che supporta la paginazione, il token di continuazione nextPageToken viene restituito nella risposta se la scheda è incompleta. 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 da utilizzare per continuare a elencare gli oggetti in my-bucket è 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 la scheda è incompleta. NextContinuationToken rappresenta l'ultimo risultato restituito. Quando passi il valore di NextContinuationToken al parametro continuation-token di una richiesta successiva, restituisci la pagina di risultati successiva, 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 valore NextContinuationToken quando elenchi gli oggetti.

La richiesta HTTP da utilizzare per continuare a elencare gli oggetti in my-bucket includerà quanto segue:

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

Per istruzioni più dettagliate sulla visualizzazione dei risultati di un separato in pagine, consulta la documentazione di riferimento XML per List Objects.

Passaggi successivi