Questa pagina descrive come visualizzare e modificare i metadati associati agli oggetti in Cloud Storage.
Questa pagina non riguarda la visualizzazione o la modifica di Identity and Access Management i criteri (IAM) o gli elenchi di controllo di accesso (ACL) degli oggetti, entrambi che controllano chi di accedere ai tuoi dati. Consulta Utilizzo delle autorizzazioni IAM e Creazione e gestione degli ACL per le guide allo svolgimento di queste attività.
Ruoli obbligatori
Per ottenere le autorizzazioni necessarie per la visualizzazione e la modifica dei metadati
chiedi all'amministratore di concederti il ruolo Utente oggetti Storage
(roles/storage.objectUser
) nel bucket.
Questo ruolo contiene le autorizzazioni necessarie per visualizzare e modificare i metadati di oggetti strutturati. Per vedere con esattezza le autorizzazioni necessarie, espandi la sezione Sezione Autorizzazioni obbligatorie:
Autorizzazioni obbligatorie
storage.buckets.list
- Questa autorizzazione è necessaria solo se prevedi di utilizzare nella console Google Cloud per eseguire le attività descritte in questa pagina.
storage.objects.get
storage.objects.getIamPolicy
- Questa autorizzazione è necessaria solo se vuoi restituire la proprietà Criteri IAM.
storage.objects.list
storage.objects.setRetention
- Questa autorizzazione è necessaria solo se vuoi impostare il valore configurazione di conservazione.
storage.objects.update
Potresti riuscire a ottenere queste autorizzazioni anche con altri ruoli predefiniti o ruoli personalizzati.
Per istruzioni sulla concessione dei ruoli nei bucket, consulta Utilizzare IAM con i bucket.
Visualizzazione dei metadati degli oggetti
Completa le seguenti istruzioni per visualizzare i metadati associati a un :
Console
- Nella console Google Cloud, vai alla pagina Bucket di Cloud Storage.
Nell'elenco dei bucket, fai clic sul nome del bucket che contiene l'oggetto di cui vuoi visualizzare i metadati.
Si apre la pagina Dettagli bucket, con la scheda Oggetti selezionata.
Accedi all'oggetto, che potrebbe trovarsi in una cartella.
Alcuni valori dei metadati degli oggetti, come le dimensioni e , vengono visualizzate insieme al nome dell'oggetto.
Fai clic sul nome dell'oggetto.
Si apre la pagina Dettagli oggetto, che mostra altri oggetti metadati.
Fai clic su Modifica metadati.
La finestra di overlay visualizzata mostra i valori correnti di diversi più chiavi di metadati degli oggetti, inclusi metadati personalizzati.
Scopri come ottenere informazioni dettagliate sugli errori relativi a Cloud Storage non riusciti nella console Google Cloud, vedi 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 la cui i metadati che vuoi visualizzare. Ad esempio,cat.jpeg
.
Se l'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 ulteriori informazioni, consulta API Cloud Storage C++ documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
C#
Per ulteriori informazioni, consulta API Cloud Storage C# documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Go
Per ulteriori informazioni, consulta API Cloud Storage Go documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Java
Per ulteriori informazioni, consulta API Cloud Storage Java documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Node.js
Per ulteriori informazioni, consulta API Cloud Storage Node.js documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
PHP
Per ulteriori informazioni, consulta API Cloud Storage PHP documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Python
Per ulteriori informazioni, consulta API Cloud Storage Python documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Ruby
Per ulteriori informazioni, consulta API Cloud Storage Ruby documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Terraform
Puoi utilizzare una risorsa Terraform per visualizzare la proprietà metadati.
API REST
API JSON
Avere gcloud CLI installato e inizializzato, per generare un token di accesso per l'intestazione
Authorization
.In alternativa, puoi creare un token di accesso utilizzando il metodo OAuth 2.0 Playground e includilo nell'intestazione
Authorization
.Utilizza
cURL
per chiamare l'API JSON con un RichiestaGET
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 codificato nell'URL di l'oggetto di cui vuoi visualizzare i metadati. Ad esempio,pets/dog.png
, con codifica URLpets%2Fdog.png
.
API XML
Avere gcloud CLI installato e inizializzato, per generare un token di accesso per l'intestazione
Authorization
.In alternativa, puoi creare un token di accesso utilizzando il metodo OAuth 2.0 Playground e includilo nell'intestazione
Authorization
.Utilizza
cURL
per chiamare l'API XML con un RichiestaHEAD
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 codificato nell'URL di l'oggetto di cui vuoi visualizzare i metadati. Ad esempio,pets/dog.png
, con codifica URLpets%2Fdog.png
.
Modifica metadati oggetto
Completa i seguenti passaggi per modificare i metadati associati a un oggetto:
Console
- Nella console Google Cloud, vai alla pagina Bucket di Cloud Storage.
Nell'elenco dei bucket, fai clic sul nome del bucket che contiene e l'oggetto di cui vuoi modificare i metadati.
Si apre la pagina Dettagli bucket, con la scheda Oggetti selezionata.
Accedi all'oggetto, che potrebbe trovarsi in una cartella.
Fai clic sul nome dell'oggetto.
Si apre la pagina Dettagli oggetto, che mostra i metadati dell'oggetto.
Fai clic sull'icona a forma di matita associata ai metadati da modificare. se appare sulla pagina.
Altrimenti, fai clic su Modifica metadati per accedere ad altri metadati.
Nella finestra di overlay visualizzata, modifica i metadati in base alle tue esigenze.
Per i campi dei metadati standard, modifica il Valore.
Aggiungi i tuoi metadati personalizzati facendo clic sul add_box Aggiungi elemento.
Puoi modificare sia la chiave che il valore dei tuoi metadati personalizzati.
Elimina i metadati personalizzati facendo clic sulla X associata.
Una volta terminata la modifica dei metadati nella finestra dell'overlay, fai clic su Salva.
Scopri come ottenere informazioni dettagliate sugli errori relativi a Cloud Storage non riusciti nella console Google Cloud, vedi 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 contenente l'oggetto di cui vuoi modificare i metadati. Ad esempio:my-bucket
.OBJECT_NAME
è il nome dell'oggetto la cui e i metadati che desideri modificare. Ad esempio,pets/dog.png
.METADATA_FLAG
è il flag per i metadati che che vuoi modificare. Ad esempio--content-type=image/png
.
Se l'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 ai comandi.
Librerie client
C++
Per ulteriori informazioni, consulta API Cloud Storage C++ documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
C#
Per ulteriori informazioni, consulta API Cloud Storage C# documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Go
Per ulteriori informazioni, consulta API Cloud Storage Go documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Java
Per ulteriori informazioni, consulta API Cloud Storage Java documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Node.js
Per ulteriori informazioni, consulta API Cloud Storage Node.js documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
PHP
Per ulteriori informazioni, consulta API Cloud Storage PHP documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Python
Per ulteriori informazioni, consulta API Cloud Storage Python documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Ruby
Per ulteriori informazioni, consulta API Cloud Storage Ruby documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
API REST
API JSON
Avere gcloud CLI installato e inizializzato, per generare un token di accesso per l'intestazione
Authorization
.In alternativa, puoi creare un token di accesso utilizzando il metodo OAuth 2.0 Playground e includilo nell'intestazione
Authorization
.Crea un file JSON contenente i metadati che vuoi modificare.
Per aggiungere o modificare metadati a chiave fissa come
contentType
, utilizza il seguente formato:{ "STANDARD_METADATA_KEY": "STANDARD_METADATA_VALUE" }
Dove:
STANDARD_METADATA_KEY
è la chiave per i metadati che desideri aggiungere o modificare. Ad esempio,Content-Type
.STANDARD_METADATA_VALUE
è il valore di i metadati che vuoi aggiungere o modificare. Ad esempio,image/png
.
Per aggiungere o modificare i metadati personalizzati, utilizza il formato seguente:
{ "metadata": { "CUSTOM_METADATA_KEY": "CUSTOM_METADATA_VALUE" } }
Dove:
CUSTOM_METADATA_KEY
sono i metadati personalizzati chiave che vuoi aggiungere o modificare. Ad esempio,dogbreed
.CUSTOM_METADATA_VALUE
è il valore che da associare alla chiave dei metadati personalizzata. Ad esempio:shibainu
.
Per eliminare una voce di metadati personalizzati, utilizza il formato seguente:
{ "metadata": { "CUSTOM_METADATA_KEY": null } }
Dove:
CUSTOM_METADATA_KEY
è la chiave per e i metadati personalizzati che vuoi eliminare. Ad esempio,dogbreed
.
Utilizza
cURL
per chiamare l'API JSON con un RichiestaPATCH
oggetto: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 creato nel passaggio 2.BUCKET_NAME
è il nome del bucket contenente l'oggetto di cui vuoi modificare i metadati. Ad esempio,my-bucket
.OBJECT_NAME
è il nome codificato nell'URL del dell'oggetto di cui vuoi modificare i metadati. Ad esempio,pets/dog.png
, con codifica URLpets%2Fdog.png
.
Tieni presente che puoi anche modificare i metadati di un oggetto con un
Richiesta Oggetto UPDATE
. Quando utilizzi questo metodo, tutti i metadati
che non è esplicitamente specificato nella richiesta, viene rimosso dal
metadati dell'oggetto.
API XML
Quando si utilizza l'API XML, i metadati possono essere impostati solo volta in cui viene scritto l'oggetto, ad esempio durante il caricamento, lo spostamento sostituendo l'oggetto. Segui istruzioni come per il caricamento di un oggetto seguendo queste linee guida:
Aggiungi
-H "METADATA_KEY:METADATA_VALUE"
all'intestazione della richiesta per ogni valore dei metadati che imposti. Ad esempio,-H "Content-Type:image/png"
.Aggiungi il prefisso
x-goog-meta-
a qualsiasi valore di metadati personalizzato. Un esempio di"METADATA_KEY:METADATA_VALUE"
personalizzata è"x-goog-meta-dogbreed:shibainu"
.
Per ulteriori informazioni, consulta Caricare un oggetto per XML.
Passaggi successivi
- Scopri di più sui metadati associati a un oggetto.
- Recupera i metadati del bucket.
- Modifica la classe di archiviazione di un oggetto.
- Aggiungi un blocco a un oggetto.
- Scopri come utilizzare le condizioni preliminari delle richieste per evitare che i metadati degli oggetti la variazione tra le richieste.