Questa pagina descrive come visualizzare e modificare i metadati associati agli oggetti archiviati in Cloud Storage.
Questa pagina non tratta la visualizzazione o la modifica delle policy Identity and Access Management (IAM) o degli elenchi di controllo dell'accesso (ACL) degli oggetti, che controllano chi è autorizzato ad accedere ai tuoi dati. Consulta le guide Utilizzo delle autorizzazioni IAM e Creazione e gestione degli elenchi di controllo degli accessi per svolgere queste attività.
Ruoli obbligatori
Per ottenere le autorizzazioni necessarie per visualizzare e modificare i metadati degli oggetti, chiedi all'amministratore di concederti il ruolo Utente oggetti Storage (roles/storage.objectUser
) per il bucket.
Questo ruolo contiene le autorizzazioni necessarie per visualizzare e modificare i metadati degli oggetti. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:
Autorizzazioni obbligatorie
storage.buckets.list
- Questa autorizzazione è necessaria solo se prevedi di utilizzare la console Google Cloud per eseguire le attività descritte in questa pagina.
storage.objects.get
storage.objects.getIamPolicy
- Questa autorizzazione è obbligatoria solo se vuoi restituire i criteri IAM di un oggetto.
storage.objects.list
storage.objects.setRetention
- Questa autorizzazione è obbligatoria solo se vuoi impostare la configurazione di conservazione di un oggetto.
storage.objects.update
Potresti anche ottenere queste autorizzazioni con altri ruoli predefiniti o ruoli personalizzati.
Per istruzioni sulla concessione dei ruoli sui bucket, consulta Utilizzare IAM con i bucket.
Visualizzazione dei metadati degli oggetti
Completa le seguenti istruzioni per visualizzare i metadati associati a un oggetto:
Console
- Nella console Google Cloud , vai alla pagina Bucket in Cloud Storage.
Nell'elenco dei bucket, fai clic sul nome del bucket che contiene l'oggetto di cui vuoi visualizzare i metadati.
Viene visualizzata la pagina Dettagli bucket, con la scheda Oggetti selezionata.
Vai all'oggetto, che potrebbe trovarsi in una cartella.
Alcuni valori dei metadati dell'oggetto, come le dimensioni e la classe di archiviazione dell'oggetto, vengono visualizzati insieme al nome dell'oggetto.
Fai clic sul nome dell'oggetto.
Si apre la pagina Dettagli oggetto, che mostra metadati aggiuntivi dell'oggetto.
Fai clic su Modifica metadati.
La finestra di overlay visualizzata mostra i valori attuali di diverse altre chiavi di metadati dell'oggetto, inclusi i metadati personalizzati.
Per scoprire come ottenere informazioni dettagliate sugli errori relativi alle operazioni di Cloud Storage non riuscite nella console Google Cloud , consulta Risoluzione dei problemi.
Riga di comando
Utilizza il comando gcloud storage objects describe
:
gcloud storage objects describe gs://BUCKET_NAME/OBJECT_NAME
Dove:
BUCKET_NAME
è il nome del bucket contenente l'oggetto di cui vuoi visualizzare i metadati. Ad esempio,my-awesome-bucket
.OBJECT_NAME
è il nome dell'oggetto di cui vuoi visualizzare i metadati. Ad esempio,cat.jpeg
.
Se l'operazione ha esito positivo, la risposta è simile al seguente esempio:
bucket: my-awesome-bucket content_type: image/png crc32c_hash: pNKjPQ== creation_time: 2024-01-26T21:33:04+0000 custom_fields: Animal: Cat Type: Cute custom_time: 1970-01-01T00:00:00+0000 etag: CMXyydSA/IMDEAE= generation: '1706304784726341' md5_hash: KCbI3PYk1aHfekIvf/osrw== metageneration: 1 name: kitten.png size: 168276 storage_class: STANDARD storage_class_update_time: 2024-01-26T21:33:04+0000 storage_url: gs://my-awesome-bucket/kitten.png#1706304784726341 update_time: 2024-01-26T21:33:04+0000
Librerie client
C++
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage C++.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
C#
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage C#.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Go
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Go.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Java
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Java.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Node.js
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Node.js.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
PHP
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage PHP.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Python
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Python.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Ruby
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Ruby.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Terraform
Puoi utilizzare una risorsa Terraform per visualizzare i metadati di un oggetto.
API REST
API JSON
Avere la gcloud CLI installata e inizializzata, che ti consente di generare un token di accesso per l'intestazione
Authorization
.Utilizza
cURL
per chiamare l'API JSON con una richiesta diGET
oggetto:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/o/OBJECT_NAME"
Dove:
BUCKET_NAME
è il nome del bucket contenente l'oggetto di cui vuoi visualizzare i metadati. Ad esempio,my-bucket
.OBJECT_NAME
è il nome con codifica URL dell'oggetto di cui vuoi visualizzare i metadati. Ad esempio,pets/dog.png
, codificato come URLpets%2Fdog.png
.
API XML
Avere la gcloud CLI installata e inizializzata, che ti consente di generare un token di accesso per l'intestazione
Authorization
.Utilizza
cURL
per chiamare l'API XML con una richiesta diHEAD
oggetto:curl -I HEAD \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/BUCKET_NAME/OBJECT_NAME"
Dove:
BUCKET_NAME
è il nome del bucket contenente l'oggetto di cui vuoi visualizzare i metadati. Ad esempio,my-bucket
.OBJECT_NAME
è il nome con codifica URL dell'oggetto di cui vuoi visualizzare i metadati. Ad esempio,pets/dog.png
, codificato come URLpets%2Fdog.png
.
Modifica metadati oggetto
Per modificare i metadati associati a un oggetto:
Console
- Nella console Google Cloud , vai alla pagina Bucket in Cloud Storage.
Nell'elenco dei bucket, fai clic sul nome del bucket contenente l'oggetto per cui vuoi modificare i metadati.
Viene visualizzata la pagina Dettagli bucket, con la scheda Oggetti selezionata.
Vai all'oggetto, che potrebbe trovarsi in una cartella.
Fai clic sul nome dell'oggetto.
Viene visualizzata la pagina Dettagli oggetto, che mostra i metadati dell'oggetto.
Fai clic sull'icona a forma di matita associata ai metadati che vuoi modificare, se viene visualizzata nella pagina.
In caso contrario, fai clic su Modifica metadati per accedere a metadati modificabili aggiuntivi.
Nella finestra di overlay visualizzata, modifica i metadati in base alle tue esigenze.
Per i campi di metadati standard, modifica il Valore.
Aggiungi i tuoi metadati personalizzati facendo clic sul pulsante add_box Aggiungi elemento.
Puoi modificare sia la chiave che il valore dei metadati personalizzati.
Elimina i metadati personalizzati facendo clic sulla X associata.
Una volta terminata la modifica dei metadati nella finestra di overlay, fai clic su Salva.
Per scoprire come ottenere informazioni dettagliate sugli errori relativi alle operazioni di Cloud Storage non riuscite nella console Google Cloud , consulta Risoluzione dei problemi.
Riga di comando
Utilizza il comando gcloud storage objects update
:
gcloud storage objects update gs://BUCKET_NAME/OBJECT_NAME METADATA_FLAG
Dove:
BUCKET_NAME
è il nome del bucket che contiene l'oggetto di cui vuoi modificare i metadati. Ad esempio,my-bucket
.OBJECT_NAME
è il nome dell'oggetto di cui vuoi modificare i metadati. Ad esempio,pets/dog.png
.METADATA_FLAG
è il flag per i metadati che vuoi modificare. Ad esempio--content-type=image/png
.
Se l'operazione ha esito positivo, la risposta è simile al seguente esempio:
Patching gs://my-bucket/pets/dog.png#1560574162144861... Completed 1
Per un elenco completo dei metadati che puoi aggiornare con questo comando, consulta la pagina di riferimento del comando.
Librerie client
C++
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage C++.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
C#
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage C#.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Go
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Go.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Java
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Java.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Node.js
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Node.js.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
PHP
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage PHP.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Python
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Python.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Ruby
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Ruby.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
API REST
API JSON
Avere la gcloud CLI installata e inizializzata, che ti consente di generare un token di accesso per l'intestazione
Authorization
.Crea un file JSON che contenga i metadati che vuoi modificare. Per ulteriori informazioni sui metadati associati a un oggetto, consulta la risorsa Oggetti Cloud Storage.
Per aggiungere o modificare i metadati con chiavi fisse, ad esempio
contentType
, utilizza il seguente formato:{ "STANDARD_METADATA_KEY": "STANDARD_METADATA_VALUE" }
Dove:
STANDARD_METADATA_KEY
è la chiave per i metadati che vuoi aggiungere o modificare. Ad esempio,contentType
.STANDARD_METADATA_VALUE
è il valore dei metadati che vuoi aggiungere o modificare. Ad esempio,image/png
.
Per aggiungere o modificare metadati personalizzati, utilizza il seguente formato:
{ "metadata": { "CUSTOM_METADATA_KEY": "CUSTOM_METADATA_VALUE" } }
Dove:
CUSTOM_METADATA_KEY
è la chiave dei metadati personalizzati che vuoi aggiungere o modificare. Ad esempio,dogbreed
.CUSTOM_METADATA_VALUE
è il valore che vuoi associare alla chiave dei metadati personalizzati. Ad esempio,shibainu
.
Per eliminare una voce di metadati personalizzati, utilizza il seguente formato:
{ "metadata": { "CUSTOM_METADATA_KEY": null } }
Dove:
CUSTOM_METADATA_KEY
è la chiave dei metadati personalizzati che vuoi eliminare. Ad esempio,dogbreed
.
Utilizza
cURL
per chiamare l'API JSON con una richiestaPATCH
Object:curl -X PATCH --data-binary @JSON_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/o/OBJECT_NAME"
Dove:
JSON_FILE_NAME
è il percorso del file che hai creato nel passaggio 2.BUCKET_NAME
è il nome del bucket che contiene l'oggetto di cui vuoi modificare i metadati. Ad esempio,my-bucket
.OBJECT_NAME
è il nome con codifica URL dell'oggetto di cui vuoi modificare i metadati. Ad esempio,pets/dog.png
, codificato come URLpets%2Fdog.png
.
Tieni presente che puoi anche modificare i metadati di un oggetto con una richiesta
UPDATE
Object. Quando utilizzi questo metodo, tutti i metadati
non specificati esplicitamente nella richiesta vengono rimossi dai
metadati dell'oggetto.
API XML
Quando utilizzi l'API XML, i metadati possono essere impostati solo al momento della scrittura dell'oggetto, ad esempio durante il caricamento, lo spostamento o la sostituzione dell'oggetto. Segui le istruzioni, ad esempio caricare un oggetto, con le seguenti linee guida:
Aggiungi
-H "METADATA_KEY:METADATA_VALUE"
all'intestazione della richiesta per ogni valore dei metadati che stai impostando. Ad esempio,-H "Content-Type:image/png"
.Aggiungi il prefisso
x-goog-meta-
a qualsiasi valore dei metadati personalizzati. Un esempio di"METADATA_KEY:METADATA_VALUE"
personalizzato è"x-goog-meta-dogbreed:shibainu"
.
Per ulteriori informazioni, vedi Caricare un oggetto per XML.
Passaggi successivi
- Scopri di più sui metadati associati a un oggetto.
- Recupera i metadati del bucket.
- Modificare la classe di archiviazione di un oggetto.
- Aggiungere una sospensione a un oggetto.
- Scopri come utilizzare le precondizioni delle richieste per assicurarti che i metadati degli oggetti non cambino tra le richieste.