Paginare i risultati

Questa pagina descrive in che modo diversi strumenti e librerie Cloud Storage paginano i risultati. L'impaginazione è obbligatoria quando viene elencato un numero objects o bucket.

Console

La console Google Cloud esegue automaticamente l'impaginazione degli elenchi di bucket e oggetti pagine Bucket e Dettagli bucket.


Apri la pagina Bucket

Riga di comando

Google Cloud CLI esegue automaticamente l'impaginazione degli elenchi di bucket e oggetti.

Librerie client

C++

Le librerie client eseguono l'impaginazione per impostazione predefinita. Quando chiami una funzione che supporta l'impaginazione, nella risposta viene restituito un iteratore. Per un esempio di come viene utilizzato questo iteratore; vedi il riferimento a C++ documentazione per ListObjects().

C#

Le librerie client eseguono l'impaginazione per impostazione predefinita. Quando chiami una funzione che supporta l'impaginazione, nella risposta viene restituito un iteratore. Per per vedere un esempio di come viene utilizzato questo iteratore, vedi il riferimento C# documentazione per ListObjects().

Vai

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

Java

Le librerie client eseguono la paginazione per impostazione predefinita. Quando chiami una funzione che supporta l'impaginazione, nella risposta viene restituito un iteratore. Per esempio di come viene usato questo iteratore; vedi il riferimento Java documentazione per Storage.Objects.list.

Node.js

Le librerie client eseguono l'impaginazione per impostazione predefinita. Quando chiami una funzione che supporta l'impaginazione, nella risposta viene restituito un iteratore. Per esempio di come viene utilizzato questo iteratore; vedi il riferimento di Node.js documentazione per getFiles().

PHP

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

Python

Le librerie client eseguono l'impaginazione per impostazione predefinita. Quando chiami una funzione che supporta l'impaginazione, 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 l'impaginazione per impostazione predefinita. Quando chiami una funzione che supporta l'impaginazione, nella risposta viene restituito un iteratore. Per per vedere un esempio di come viene usato questo iteratore, vedi il riferimento a Ruby documentazione per Google::Cloud::Storage::File::List.

API REST

API JSON

Quando chiami una funzione che supporta l'impaginazione, la continua il token nextPageToken viene restituito nella risposta se l'elenco incompleta. nextPageToken rappresenta l'ultimo risultato restituito. Quando passi il valore di nextPageToken al parametro pageToken di una richiesta successiva, restituisci pagina successiva dei risultati, iniziando dopo l'ultimo risultato.

Risposta di esempio

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

Per saperne di più su objects Resource, consulta la documentazione di riferimento sugli oggetti.

Richiesta di esempio

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

Authorization: Bearer ACCESS_TOKEN
Accept: application/json

Dove:

  • NEXT_PAGE_TOKEN è il valore nextPageToken della risposta precedente.
  • BUCKET_NAME è il nome del tuo bucket di archiviazione.
  • ACCESS_TOKEN è il token di accesso che ricevi OAuth 2.0 Playground.

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 l'impaginazione, la continua il token NextContinuationToken viene restituito nella risposta se l'elenco è incompleta. NextContinuationToken rappresenta l'ultimo risultato che viene restituito. Quando passi il valore NextContinuationToken al parametro continuation-token di un successiva, viene restituita la pagina dei risultati successiva, che inizia dopo l'ultimo risultato.

Esempio di risposta

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>

Tieni presente che list-type deve essere impostato su 2 per poter restituire un NextContinuationToken.

Richiesta di esempio

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

Dove:

  • NEXT_CONTINUATION_TOKEN è la NextContinuationToken che ricevi dalla risposta precedente.
  • BUCKET_NAME è il nome del tuo bucket di archiviazione.
  • AUTHENTICATION_STRING è il token di accesso che ricevi tramite OAuth 2.0 Playground.

Per istruzioni più dettagliate sull'impaginazione dei risultati da un consulta la documentazione di riferimento XML per List Objects.

Passaggi successivi