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