Questa pagina descrive come i diversi strumenti e librerie di Cloud Storage determinano le pagine dei risultati. L'impaginazione è obbligatoria quando elenchi un numero elevato di oggetti o bucket.
Console
La console Google Cloud impagina automaticamente gli elenchi di bucket e oggetti nelle pagine Bucket e Dettagli bucket.
Riga di comando
Google Cloud CLI impagina automaticamente gli 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, consulta la documentazione di riferimento di C++ 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 un esempio di come viene utilizzato questo iteratore, consulta la documentazione di riferimento C# per ListObjects().
Go
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 Go per Bucket.Objects.
Java
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 Java 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 un esempio di come viene utilizzato questo iteratore, consulta la documentazione di riferimento di Node.js per getFiles().
PHP
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 PHP 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 pagina.
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 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 l'impaginazione, il token di continuazione nextPageToken viene restituito nella risposta se l'elenco non è completo. nextPageToken rappresenta l'ultimo risultato restituito. Quando passi il valore di nextPageToken al parametro pageToken di una richiesta successiva, restituisci la pagina di risultati successiva, a partire dall'ultimo risultato.
Esempio di risposta
{
"kind": "storage#objects",
"nextPageToken": "CgtzaGliYS0yLmpwZw==",
"items": [
objects Resource
…
]
}
Per maggiori informazioni su objects Resource, consulta la
documentazione di riferimento degli 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
nextPageTokendella risposta precedente. - BUCKET_NAME è il nome del tuo bucket di archiviazione.
- ACCESS_TOKEN è il token di accesso che ricevi da OAuth 2.0 Playground.
Per ulteriori informazioni sull'impaginazione dei risultati, consulta la documentazione di riferimento JSON per Objects: list o Buckets: list.
API XML
Quando chiami una funzione che supporta l'impaginazione, il token di continuazione NextContinuationToken viene restituito nella risposta se l'elenco è incompleto. NextContinuationToken rappresenta l'ultimo risultato
restituito. Quando passi il valore di NextContinuationToken al parametro continuation-token di una richiesta successiva, viene restituita la pagina di risultati successiva, a partire dall'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 è il valore
NextContinuationTokenche ricevi dalla risposta precedente. - BUCKET_NAME è il nome del tuo bucket di archiviazione.
- AUTHENTICATION_STRING è il token di accesso che ricevi da OAuth 2.0 Playground.
Per istruzioni più dettagliate sull'impaginazione dei risultati di un bucket, consulta la documentazione di riferimento XML per List Objects.