Utilizzo delle etichette dei bucket (original) (raw)

Passa ai contenuti principali

• Aree tecnologiche

  • Panoramica
  • Guide
  • Riferimento
  • Esempi
  • Risorse

• Strumenti per più prodotti

• Console

• Scopri

• Panoramica del prodotto

• Panoramica di Storage Intelligence

• Per iniziare

• Supporto di Terraform per Cloud Storage

• Configura e gestisci Storage Intelligence

• Crea bucket

• Crea un bucket

• Verifica dei bucket con nome di dominio

• Accedere ai bucket e gestirli

• Elenca bucket

• Modificare la classe di archiviazione predefinita di un bucket

• Spostare e rinominare i bucket

• Elimina bucket

• Caricare e scaricare oggetti

• Informazioni sugli oggetti

• Panoramica di caricamenti e download

• Carica oggetti

  • Caricare oggetti dai file
  • Caricare oggetti dalla memoria
  • Caricamenti multiparte dell'API XML
  • Caricamenti paralleli composti
  • Caricamenti di flussi di dati

• Accedere e gestire gli oggetti

• Elenco degli oggetti

• Copiare, rinominare e spostare gli oggetti

• Modificare la classe di archiviazione di un oggetto

• Strumenti per accedere agli oggetti e gestirli utilizzando una struttura di directory

• Transcodifica degli oggetti

• Elimina oggetti

• Ottenere approfondimenti sui dati archiviati

• Analizzare i dati archiviati con Gemini Cloud Assist

• Oggetti della cache

• Informazioni sulla memorizzazione nella cache

• Controllare i cicli di vita dei dati

• Opzioni per controllare i cicli di vita dei dati

• Fare richieste

• Coerenza nelle operazioni di Cloud Storage

• Richieste in batch

• Utilizzare le operazioni a lunga esecuzione

• Impagina i risultati

• Caratteri jolly URI

• Rendi sicuri i dati

• Controllo dell'accesso

  • Panoramica
  • Filtro IP del bucket
    * Panoramica
    * Crea un bucket con regole di filtro IP
    * Creare o aggiornare regole di filtro IP in un bucket esistente
    * Ottieni regole di filtro dei bucket IP
    * Elenca regole di filtro IP del bucket
    * Elimina regole di filtro IP del bucket
    * Disattiva il filtro IP del bucket
    * Ignora le regole di filtro IP del bucket
  • Scenari di condivisione e collaborazione
  • Best practice di controllo dell'accesso

• Monitorare i dati e l'utilizzo

• Utilizzo di Cloud Audit Logs con Cloud Storage

• Log di utilizzo e log di archiviazione

• Utilizzare Cloud Audit Logs con le operazioni batch di archiviazione

• Utilizzare Cloud Logs con le operazioni batch di archiviazione

• Utilizzare Cloud Audit Logs con Storage Insights

• Utilizzare le metriche lato client gRPC

• Utilizza le tracce lato client

• Protezione, backup e ripristino

• Panoramica

• Eliminazione temporanea

  • Panoramica
  • Impostare e gestire i criteri di eliminazione temporanea
  • Utilizzare gli oggetti eliminati temporaneamente
  • Utilizzare i bucket eliminati temporaneamente
  • Imposta una durata di conservazione predefinita per l'eliminazione temporanea
  • Utilizzare i suggerimenti per l'eliminazione temporanea
  • Disabilita l'eliminazione temporanea

• Monta i bucket con Cloud Storage FUSE

• Panoramica

• Guida rapida

• Installa Cloud Storage FUSE

• Montare i bucket

• Rendimento

  • Best practice per l'ottimizzazione delle prestazioni
  • Configurazioni basate sul profilo per i workload AI/ML
  • Valori di configurazione automatizzati per i tipi di macchine ad alte prestazioni
  • Utilizza file YAML GKE preconfigurati per ottimizzare le prestazioni di Cloud Storage FUSE

• Lavorare su prodotti, cloud e piattaforme

• Best practice per i carichi di lavoro multimediali

• Interoperabilità

• Utilizzo di Cloud Storage con Big Data

• Integrazione con servizi e strumenti di Google Cloud Platform

• Risoluzione dei problemi

• Risoluzione dei problemi più comuni

• Risoluzione dei problemi di Storage Insights

• Risoluzione dei problemi di Cloud Storage FUSE

Utilizzo delle etichette dei bucket

Questa pagina mostra come aggiungere, modificare, rimuovere e visualizzare le etichette impostate su 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 archiviazione (roles/storage.admin) sul bucket.

Questo ruolo predefinito contiene le autorizzazioni necessarie per aggiungere e gestire le etichette dei bucket. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

• storage.buckets.get
• storage.buckets.list
  • Questa autorizzazione è necessaria solo se prevedi di utilizzare la consoleGoogle Cloud per eseguire le istruzioni riportate in questa pagina.
• storage.buckets.update

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati.

Per istruzioni sulla concessione dei ruoli sui bucket, consultaImpostare e gestire le policy IAM sui bucket.

Aggiungere, modificare o rimuovere le etichette di un bucket

Console

1. Nella console Google Cloud , vai alla pagina Bucket in Cloud Storage.
   Vai a Bucket
2. Nell'elenco dei bucket, fai clic sul nome del bucket per cui vuoi aggiungere, modificare o rimuovere le etichette.
3. Nella pagina Dettagli bucket, fai clic sulla scheda Configurazione.
4. Fai clic sull'icona Modifica() per Etichette.
   Viene visualizzata la finestra dell'editor delle etichette.
   1. Per aggiungere un'etichetta, fai clic sul pulsanteAggiungi etichetta e specifica un key e un value per l'etichetta.
   2. Per modificare un'etichetta esistente, fai clic sul relativo Valore e inserisci un nuovo valore.
   3. Per rimuovere un'etichetta, fai clic sull'icona del cestino associata all'etichetta che vuoi rimuovere.
5. 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 ilcomando 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 questo comando:

gcloud storage buckets update gs://BUCKET_NAME --clear-labels

Librerie client

C++

Per saperne di più, 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ù, vediConfigurare l'autenticazione per le librerie client.

Il seguente esempio aggiunge l'etichetta specificata a un bucket o la modifica se esiste già per il bucket:

L'esempio seguente rimuove l'etichetta specificata da un bucket:

C#

Per saperne di più, 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ù, vediConfigurare l'autenticazione per le librerie client.

Il seguente esempio aggiunge l'etichetta specificata a un bucket o la modifica se esiste già per il bucket:

L'esempio seguente rimuove l'etichetta specificata da un bucket:

Go

Per saperne di più, 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ù, vediConfigurare l'autenticazione per le librerie client.

Il seguente esempio aggiunge l'etichetta specificata a un bucket o la modifica se esiste già per il bucket:

L'esempio seguente rimuove l'etichetta specificata da un bucket:

Java

Per saperne di più, 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ù, vediConfigurare l'autenticazione per le librerie client.

Il seguente esempio aggiunge l'etichetta specificata a un bucket o la modifica se esiste già per il bucket:

L'esempio seguente rimuove l'etichetta specificata da un bucket:

Node.js

Per saperne di più, 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ù, vediConfigurare l'autenticazione per le librerie client.

Il seguente esempio aggiunge l'etichetta specificata a un bucket o la modifica se esiste già per il bucket:

L'esempio seguente rimuove l'etichetta specificata da un bucket:

PHP

Per saperne di più, 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ù, vediConfigurare l'autenticazione per le librerie client.

Il seguente esempio aggiunge l'etichetta specificata a un bucket o la modifica se esiste già per il bucket:

L'esempio seguente rimuove l'etichetta specificata da un bucket:

Python

Per saperne di più, 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ù, vediConfigurare l'autenticazione per le librerie client.

Il seguente esempio aggiunge l'etichetta specificata a un bucket o la modifica se esiste già per il bucket:

L'esempio seguente rimuove l'etichetta specificata da un bucket:

Ruby

Per saperne di più, 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ù, vediConfigurare l'autenticazione per le librerie client.

Il seguente esempio aggiunge l'etichetta specificata a un bucket o la modifica se esiste già per il bucket:

L'esempio seguente rimuove l'etichetta specificata da un bucket:

API REST

API JSON

1. Avere gcloud CLI installato e inizializzato, il che ti consente di generare un token di accesso per l'intestazione Authorization.
2. 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, utilizza null al posto di "<var>VALUE_1</var>".
3. Utilizza cURL per chiamare l'API JSON con una richiesta di PATCHbucket:
   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 che hai 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

1. Avere gcloud CLI installato e inizializzato, il che ti consente di generare un token di accesso per l'intestazione Authorization.
2. Crea un file XML che contenga le seguenti informazioni: 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`. Tieni presente che puoi aggiungere più elementi `` in una richiesta. Se vuoi rimuovere tutte le etichette da un bucket, utilizza un singolo elemento `` vuoto nel file:
3. Utilizza cURL per chiamare l'API XML con una richiesta PUT Bucket e il parametro della stringa di query tagging:
   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.

Visualizzare le etichette dei bucket

Console

1. Nella console Google Cloud , vai alla pagina Bucket in Cloud Storage.
   Vai a Bucket
2. Fai clic sul nome del bucket di cui vuoi visualizzare le etichette.
3. 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 ha esito positivo e sono presenti 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 saperne di più, 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ù, vediConfigurare l'autenticazione per le librerie client.

Per visualizzare le etichette di un bucket, segui le istruzioni per visualizzare i metadati di un bucket e cerca il campo dell'etichetta nella risposta.

C#

Per saperne di più, 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ù, vediConfigurare l'autenticazione per le librerie client.

Per visualizzare le etichette di un bucket, segui le istruzioni per visualizzare i metadati di un bucket e cerca il campo dell'etichetta nella risposta.

Go

Per saperne di più, 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ù, vediConfigurare l'autenticazione per le librerie client.

Per visualizzare le etichette di un bucket, segui le istruzioni per visualizzare i metadati di un bucket e cerca il campo dell'etichetta nella risposta.

Java

Per saperne di più, 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ù, vediConfigurare l'autenticazione per le librerie client.

Per visualizzare le etichette di un bucket, segui le istruzioni per visualizzare i metadati di un bucket e cerca il campo dell'etichetta nella risposta.

Node.js

Per saperne di più, 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ù, vediConfigurare l'autenticazione per le librerie client.

Per visualizzare le etichette di un bucket, segui le istruzioni per visualizzare i metadati di un bucket e cerca il campo dell'etichetta nella risposta.

PHP

Per saperne di più, 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ù, vediConfigurare l'autenticazione per le librerie client.

Per visualizzare le etichette di un bucket, segui le istruzioni per visualizzare i metadati di un bucket e cerca il campo dell'etichetta nella risposta.

Python

Per saperne di più, 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ù, vediConfigurare l'autenticazione per le librerie client.

Per visualizzare le etichette di un bucket, segui le istruzioni per visualizzare i metadati di un bucket e cerca il campo dell'etichetta nella risposta.

Ruby

Per saperne di più, 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ù, vediConfigurare l'autenticazione per le librerie client.

Per visualizzare le etichette di un bucket, segui le istruzioni per visualizzare i metadati di un bucket e cerca il campo dell'etichetta nella risposta.

API REST

Passaggi successivi

• Scopri di più sui tag dei bucket.
• Recuperare metadati del bucket aggiuntivi.

Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.

Ultimo aggiornamento 2025-12-10 UTC.