Questa pagina mostra come elencare gli oggetti archiviati nei bucket Cloud Storage, che sono ordinati nell'elenco in ordine alfabetico per nome.
Prima di iniziare
Per ottenere le autorizzazioni necessarie per elencare gli oggetti, chiedi all'amministratore di concederti il ruolo IAM Visualizzatore oggetti archiviazione (roles/storage.objectViewer
) per il bucket contenente gli oggetti che vuoi elencare.
Se prevedi di utilizzare la console Google Cloud per eseguire le attività in questa pagina,
chiedi all'amministratore di concederti il ruolo di visualizzatore (roles/viewer
) di base oltre al ruolo Visualizzatore oggetti Storage (roles/storage.objectViewer
).
Questi ruoli contengono le autorizzazioni necessarie per elencare gli oggetti. Per visualizzare le autorizzazioni esatte richieste, espandi la sezione Autorizzazioni richieste:
Autorizzazioni obbligatorie
storage.objects.list
storage.buckets.list
- Questa autorizzazione è necessaria solo se vuoi utilizzare la console Google Cloud per eseguire le attività in questa pagina.
Puoi anche ottenere queste autorizzazioni con altri ruoli predefiniti o personalizzati.
Per informazioni sulla concessione dei ruoli per i bucket, consulta Utilizzare IAM con i bucket.
Elenca gli oggetti in un bucket
Per elencare gli oggetti in un bucket:
Console
- Nella console Google Cloud, vai alla pagina Bucket in Cloud Storage.
Nell'elenco dei bucket, fai clic sul nome del bucket di cui vuoi visualizzare i contenuti.
(Facoltativo) Utilizza i filtri e l'ordinamento per limitare e organizzare i risultati nell'elenco.
Riga di comando
Utilizza il comando gcloud storage ls
con il flag --recursive
:
gcloud storage ls --recursive gs://BUCKET_NAME/**
Dove:
BUCKET_NAME
è il nome del bucket di cui vuoi elencare gli oggetti. Ad esempio,my-bucket
.
La risposta è simile al seguente esempio:
gs://my-bucket/cats.jpeg gs://my-bucket/dogs.jpeg gs://my-bucket/thesis.txt ...
Librerie client
C++
Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Storage C++.
Per autenticarti a Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
L'esempio seguente elenca tutti gli oggetti in un bucket:
L'esempio seguente elenca gli oggetti con un determinato prefisso:
C#
Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Storage C#.
Per autenticarti a Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
L'esempio seguente elenca tutti gli oggetti in un bucket:
L'esempio seguente elenca gli oggetti con un determinato prefisso:
Go
Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Storage Go.
Per autenticarti a Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
L'esempio seguente elenca tutti gli oggetti in un bucket:
L'esempio seguente elenca gli oggetti con un determinato prefisso:
Java
Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Storage Java.
Per autenticarti a Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
L'esempio seguente elenca tutti gli oggetti in un bucket:
L'esempio seguente elenca gli oggetti con un determinato prefisso:
Node.js
Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Storage Node.js.
Per autenticarti a Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
L'esempio seguente elenca tutti gli oggetti in un bucket:
L'esempio seguente elenca gli oggetti con un determinato prefisso:
PHP
Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Storage PHP.
Per autenticarti a Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
L'esempio seguente elenca tutti gli oggetti in un bucket:
L'esempio seguente elenca gli oggetti con un determinato prefisso:
Python
Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Storage Python.
Per autenticarti a Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
L'esempio seguente elenca tutti gli oggetti in un bucket:
L'esempio seguente elenca gli oggetti con un determinato prefisso:
Ruby
Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Storage Ruby.
Per autenticarti a Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
L'esempio seguente elenca tutti gli oggetti in un bucket:
L'esempio seguente elenca gli oggetti con un determinato prefisso:
API REST
API JSON
Avere installato e inizializzatogcloud CLI, che consente di generare un token di accesso per l'intestazione
Authorization
.Utilizza
cURL
per chiamare l'API JSON con una richiesta per elencare gli oggetti:curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/o"
Dove
BUCKET_NAME
è il nome del bucket cuyos oggetti vuoi elencare. Ad esempio,my-bucket
.Puoi utilizzare il parametro di query
includeFoldersAsPrefixes=True
per restituire le cartelle gestite come parte dei risultati dell'elenco. Quando utilizzi il parametroincludeFoldersAsPrefixes
, il parametrodelimiter
deve essere impostato su/
.
API XML
Avere installato e inizializzatogcloud CLI, che consente di generare un token di accesso per l'intestazione
Authorization
.Utilizza
cURL
per chiamare l'API XML con una richiestaGET
Bucket:curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/BUCKET_NAME?list-type=2"
Dove
BUCKET_NAME
è il nome del bucket cuyos oggetti vuoi elencare. Ad esempio,my-bucket
.Puoi utilizzare un parametro della stringa di query
prefix=PREFIX
per limitare i risultati agli oggetti con il prefisso specificato.
Filtrare gli oggetti
Console
Per filtrare gli oggetti in base al prefisso del nome utilizzando la console Google Cloud, utilizza il campo Filtra oggetti e cartelle nella pagina Dettagli bucket.
Consulta la sezione Filtro e ordinamento per conoscere altre opzioni di filtro disponibili tramite la console Google Cloud.
Riga di comando
Quando elenchi gli oggetti utilizzando Google Cloud CLI, puoi utilizzare i caratteri jolly per filtrare gli oggetti che iniziano con un prefisso o terminano con un suffisso specificato. Ad esempio, il seguente comando corrisponde agli oggetti che iniziano con image
e terminano con .png
:
gcloud storage ls gs://my-bucket/image*.png
Per ulteriori informazioni sull'applicazione di filtri utilizzando Google Cloud CLI, consulta la documentazione di gcloud storage ls
.
API REST
API JSON
Quando elenchi gli oggetti utilizzando l'API JSON di Cloud Storage, puoi utilizzare i parametri della stringa di query prefix
o matchGlob
per filtrare i risultati. Per informazioni dettagliate sull'utilizzo di questi parametri della stringa di query, consulta la documentazione di riferimento dell'API JSON per gli elenchi di oggetti.
Filtro per prefisso
Puoi utilizzare il parametro prefix=PREFIX
o la stringa di query per limitare i risultati a oggetti o cartelle gestite che hanno il prefisso specificato. Ad esempio, per elencare tutti gli oggetti nel bucketmy-bucket
con il prefisso folder/subfolder/
, invia una richiesta di elenco di oggetti utilizzando l'URL"https://storage.googleapis.com/storage/v1/b/my-bucket/o?prefix=folder/subfolder/"
.
L'utilizzo di prefix
per elencare i contenuti di una cartella gestita è utile quando hai l'autorizzazione per elencare solo gli oggetti nella cartella gestita, ma non nell'intero bucket. Ad esempio, supponiamo che tu abbia il ruolo IAM Visualizzatore oggetti Storage (roles/storage.objectViewer
) per la cartella gestita my-bucket/my-managed-folder-a/
, ma non per la cartella gestita my-bucket/my-managed-folder-b/
. Per restituire solo gli oggetti in my-managed-folder-a
, puoi specificare prefix=my-managed-folder-a/
.
Quando limiti i risultati a una cartella gestita e agli oggetti al suo interno,
devi terminare PREFIX
con /
(ad esempio,
prefix=my-managed-folder/
). In caso contrario, i risultati possono includere anche
gli oggetti adiacenti alla cartella gestita. In questo esempio,
hai un bucket che contiene i seguenti oggetti:
my-bucket/abc.txt
my-bucket/abc/object.txt
Se specifichi prefix=abc/
, puoi restituire gli oggetti
my-bucket/abc/object.txt
, mentre se specifichi prefix=abc
puoi restituire
sia my-bucket/abc.txt
che my-bucket/abc/object.txt
.
Filtrare per espressione glob
Puoi utilizzare il parametro della stringa di query matchGlob=GLOB_PATTERN
per filtrare i risultati in modo da visualizzare solo gli oggetti che corrispondono a una espressione glob specifica. Ad esempio, matchGlob=**.jpeg
può essere utilizzato per trovare tutti gli oggetti che terminano con .jpeg
.
Le richieste che utilizzano il parametro matchGlob
non vanno a buon fine se includono anche un parametro delimiter
impostato su un valore diverso da /
.
Considerazioni sul rendimento quando si elencano gli oggetti
La struttura sottostante dei bucket con spazio dei nomi gerarchico abilitato può influire sul rendimento dell'operazione degli oggetti della scheda rispetto ai bucket con spazio dei nomi piatto. Per saperne di più su come ottimizzare il rendimento quando vengono elencati gli oggetti nei bucket con lo spazio dei nomi gerarchico abilitato, consulta Oggetti della scheda.
Passaggi successivi
- Scarica un oggetto dal bucket.
- Visualizza e modifica i metadati degli oggetti.
- Elimina gli oggetti dal bucket.
- Scopri come paginare i risultati.