Questa pagina mostra come aggiungere, modificare, rimuovere e visualizzare le etichette impostate in un bucket in Cloud Storage.
Ruoli obbligatori
Per ottenere le autorizzazioni necessarie per aggiungere e gestire le etichette dei bucket, chiedi all'amministratore di concederti il ruolo IAM Amministratore Storage (roles/storage.admin
) per il bucket.
Questo ruolo predefinito contiene le autorizzazioni necessarie per aggiungere e gestire le etichette dei bucket. Per visualizzare le autorizzazioni esatte necessarie, espandi la sezione Autorizzazioni richieste:
Autorizzazioni obbligatorie
storage.buckets.get
storage.buckets.list
- Questa autorizzazione è necessaria solo se prevedi di utilizzare la console Google Cloud per eseguire le istruzioni in questa pagina.
storage.buckets.update
Potresti essere in grado di ottenere queste autorizzazioni anche con i ruoli personalizzati.
Per istruzioni sulla concessione dei ruoli nei bucket, consulta Utilizzare IAM con i bucket.
Aggiungi, modifica o rimuovi le etichette di un bucket
Console
- Nella console Google Cloud, vai alla pagina Bucket di Cloud Storage.
Nell'elenco dei bucket, fai clic sul nome del bucket per cui vuoi aggiungere, modificare o rimuovere le etichette.
Nella pagina Dettagli bucket, fai clic sulla scheda Configurazione.
Fai clic sull'icona Modifica (edit) per Etichette.
Viene visualizzata la finestra dell'editor delle etichette.
Per aggiungere un'etichetta, fai clic sul pulsante add_box Aggiungi etichetta e specifica un
key
e unvalue
per l'etichetta.Per modificare un'etichetta esistente, fai clic sul relativo Valore e inserisci un nuovo valore.
Per rimuovere un'etichetta, fai clic sull'icona Cestino associata all'etichetta da rimuovere.
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
Per aggiungere una nuova etichetta o aggiornarne una esistente, utilizza il comando gcloud storage buckets update
con il flag --update-labels
. Ad esempio:
gcloud storage buckets update gs://BUCKET_NAME --update-labels=KEY_1=VALUE_1
Dove
BUCKET_NAME
è il nome del bucket a cui si applica l'etichetta. Ad esempio,my-bucket
.KEY_1
è il nome della chiave per l'etichetta. Ad esempio,pet
.VALUE_1
è il valore dell'etichetta. Ad esempio,dog
.
Per rimuovere un'etichetta esistente, utilizza il flag -remove-labels
. Ad esempio:
gcloud storage buckets update gs://BUCKET_NAME --remove-labels=KEY_1
Puoi modificare più etichette utilizzando i comandi precedenti includendo le etichette in un elenco separato da virgole all'interno del flag pertinente. Ad esempio,
--update-labels=blue-key=cyan,red-key=ruby
.
Per rimuovere tutte le etichette associate a un bucket, utilizza il seguente comando:
gcloud storage buckets update gs://BUCKET_NAME --clear-labels
Librerie client
C++
Per maggiori informazioni, consulta la documentazione di riferimento dell'API C++ di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Nell'esempio seguente, l'etichetta specificata viene aggiunta a un bucket o, se esistente, viene modificata per il bucket:
L'esempio seguente rimuove l'etichetta specificata da un bucket:
C#
Per maggiori informazioni, consulta la documentazione di riferimento dell'API C# di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Nell'esempio seguente, l'etichetta specificata viene aggiunta a un bucket o, se esistente, viene modificata per il bucket:
L'esempio seguente rimuove l'etichetta specificata da un bucket:
Go
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Go di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Nell'esempio seguente, l'etichetta specificata viene aggiunta a un bucket o, se esistente, viene modificata per il bucket:
L'esempio seguente rimuove l'etichetta specificata da un bucket:
Java
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Java di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Nell'esempio seguente, l'etichetta specificata viene aggiunta a un bucket o, se esistente, viene modificata per il bucket:
L'esempio seguente rimuove l'etichetta specificata da un bucket:
Node.js
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Node.js di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Nell'esempio seguente, l'etichetta specificata viene aggiunta a un bucket o, se esistente, viene modificata per il bucket:
L'esempio seguente rimuove l'etichetta specificata da un bucket:
PHP
Per maggiori informazioni, consulta la documentazione di riferimento dell'API PHP di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Nell'esempio seguente, l'etichetta specificata viene aggiunta a un bucket o, se esistente, viene modificata per il bucket:
L'esempio seguente rimuove l'etichetta specificata da un bucket:
Python
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Python di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Nell'esempio seguente, l'etichetta specificata viene aggiunta a un bucket o, se esistente, viene modificata per il bucket:
L'esempio seguente rimuove l'etichetta specificata da un bucket:
Ruby
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Ruby di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Nell'esempio seguente, l'etichetta specificata viene aggiunta a un bucket o, se esistente, viene modificata per il bucket:
L'esempio seguente rimuove l'etichetta specificata da un bucket:
API REST
API JSON
Assicurati che gcloud CLI sia installato e inizializzatoper generare un token di accesso per l'intestazione
Authorization
.In alternativa, puoi creare un token di accesso utilizzando OAuth 2.0 Playground e includerlo nell'intestazione
Authorization
.Crea un file JSON contenente le seguenti informazioni:
{ "labels": { "KEY_1": "VALUE_1" } }
Dove
KEY_1
è il nome della chiave per l'etichetta. Ad esempio,pet
.VALUE_1
è il valore dell'etichetta. Ad esempio,dog
. Se vuoi rimuovere una chiave, usanull
al posto di"<var>VALUE_1</var>"
.
Utilizza
cURL
per chiamare l'API JSON con una richiestaPATCH
di bucket: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?fields=labels"
Dove:
JSON_FILE_NAME
è il percorso del file JSON creato nel passaggio 2.BUCKET_NAME
è il nome del bucket a cui si applica l'etichetta. Ad esempio,my-bucket
.
Puoi aggiungere, modificare o rimuovere più coppie key:value
in una richiesta.
API XML
Assicurati che gcloud CLI sia installato e inizializzatoper generare un token di accesso per l'intestazione
Authorization
.In alternativa, puoi creare un token di accesso utilizzando OAuth 2.0 Playground e includerlo nell'intestazione
Authorization
.Crea un file XML contenente le seguenti informazioni:
<Tagging> <TagSet> <Tag> <Key>KEY_1</Key> <Value>VALUE_1</Value> </Tag> </TagSet> </Tagging>
Dove:
KEY_1
è il nome della chiave per l'etichetta. Ad esempio,pet
.VALUE_1
è il valore dell'etichetta. Ad esempio,dog
.
Tieni presente che puoi aggiungere più elementi
<Tag>
in una richiesta. Se vuoi rimuovere tutte le etichette di un bucket, utilizza un singolo elemento<Tag>
vuoto nel file:<Tagging> <TagSet> <Tag> </Tag> </TagSet> </Tagging>
Utilizza
cURL
per chiamare l'API XML con una richiesta BucketPUT
e un parametro della stringa di querytagging
:curl -X PUT --data-binary @XML_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/BUCKET_NAME?tagging"
Dove:
XML_FILE_NAME
è il percorso del file XML che hai creato nel passaggio 2.BUCKET_NAME
è il nome del bucket a cui si applica l'etichetta. Ad esempio,my-bucket
.
Visualizza le etichette dei bucket
Console
- Nella console Google Cloud, vai alla pagina Bucket di Cloud Storage.
Fai clic sul nome del bucket di cui vuoi visualizzare le etichette.
Fai clic sulla scheda Configuration (Configurazione).
Le etichette impostate sul bucket sono elencate nel campo Etichette.
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 buckets describe
con il flag --format
:
gcloud storage buckets describe gs://BUCKET_NAME --format="default(labels)"
dove BUCKET_NAME
è il nome del bucket
di cui vuoi visualizzare le etichette. Ad esempio, my-bucket
.
Se l'operazione è riuscita ed esistono etichette per il bucket, la risposta è simile alla seguente:
labels: red-key: ruby blue-key: cyan
Se l'operazione ha esito positivo e le etichette non esistono per il bucket, la risposta è simile alla seguente:
null
Librerie client
C++
Per maggiori informazioni, consulta la documentazione di riferimento dell'API C++ di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Per visualizzare le etichette di un bucket, segui le istruzioni per la visualizzazione dei metadati del bucket e cerca il campo etichetta nella risposta.C#
Per maggiori informazioni, consulta la documentazione di riferimento dell'API C# di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Per visualizzare le etichette di un bucket, segui le istruzioni per la visualizzazione dei metadati del bucket e cerca il campo etichetta nella risposta.Go
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Go di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Per visualizzare le etichette di un bucket, segui le istruzioni per la visualizzazione dei metadati del bucket e cerca il campo etichetta nella risposta.Java
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Java di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Per visualizzare le etichette di un bucket, segui le istruzioni per la visualizzazione dei metadati del bucket e cerca il campo etichetta nella risposta.Node.js
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Node.js di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Per visualizzare le etichette di un bucket, segui le istruzioni per la visualizzazione dei metadati del bucket e cerca il campo etichetta nella risposta.PHP
Per maggiori informazioni, consulta la documentazione di riferimento dell'API PHP di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Per visualizzare le etichette di un bucket, segui le istruzioni per la visualizzazione dei metadati del bucket e cerca il campo etichetta nella risposta.Python
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Python di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Per visualizzare le etichette di un bucket, segui le istruzioni per la visualizzazione dei metadati del bucket e cerca il campo etichetta nella risposta.Ruby
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Ruby di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Per visualizzare le etichette di un bucket, segui le istruzioni per la visualizzazione dei metadati del bucket e cerca il campo etichetta nella risposta.API REST
API JSON
Assicurati che gcloud CLI sia installato e inizializzatoper generare un token di accesso per l'intestazione
Authorization
.In alternativa, puoi creare un token di accesso utilizzando OAuth 2.0 Playground e includerlo nell'intestazione
Authorization
.Utilizza
cURL
per chiamare l'API JSON con una richiesta BucketGET
che includa il parametro della stringa di queryfields=labels
:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=labels"
dove
BUCKET_NAME
è il nome del bucket di cui vuoi visualizzare le etichette. Ad esempio,my-bucket
.
La risposta è simile al seguente esempio:
{ "labels" : { (your_label_key): your_label_value }, }
API XML
Assicurati che gcloud CLI sia installato e inizializzatoper generare un token di accesso per l'intestazione
Authorization
.In alternativa, puoi creare un token di accesso utilizzando OAuth 2.0 Playground e includerlo nell'intestazione
Authorization
.Utilizza
cURL
per chiamare l'API XML con una richiesta BucketGET
e un parametro della stringa di querytagging
:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/BUCKET_NAME?tagging"
dove
BUCKET_NAME
è il nome del bucket di cui vuoi visualizzare le etichette. Ad esempio,my-bucket
.
La risposta è simile al seguente esempio:
<Tagging> <TagSet> <Tag> <Key>your_label_key</Key> <Value>your_label_value</Value> </Tag> </TagSet> </Tagging>
Passaggi successivi
- Scopri di più sui tag bucket.
- Ottieni altri metadati del bucket.