Gestione delle etichette

Questa pagina mostra come utilizzare le etichette con le istanze Filestore. Viene inoltre spiegato come aggiungere, aggiornare ed eliminare le etichette per un in esecuzione in un'istanza Compute Engine. Le etichette consentono di raggruppare le istanze correlate e archiviare i metadati su un'istanza.

Cosa sono le etichette?

Un'etichetta è una coppia chiave-valore che puoi assegnare alle istanze Google Cloud Filestore. Aiutano a organizzare queste risorse e a gestire i costi su larga scala, con la granularità di cui hai bisogno. Puoi associare un'etichetta a ogni risorsa e poi filtrare le risorse in base alle etichette. Le informazioni relative alle etichette vengono inoltrate al sistema di fatturazione, che consente di suddividere gli addebiti fatturati per etichetta. Con i report di fatturazione integrati, puoi filtrare e raggruppare i costi in base alle etichette delle risorse. Puoi utilizzare le etichette anche eseguire query sulle esportazioni dei dati di fatturazione.

Requisiti per le etichette

Le etichette applicate a una risorsa devono soddisfare i seguenti requisiti requisiti:

  • Ogni risorsa può avere fino a 64 etichette.
  • Ogni etichetta deve essere una coppia chiave-valore.
  • Le chiavi hanno una lunghezza minima di 1 carattere e una lunghezza massima di 63 e non può essere vuoto. I valori possono essere vuoti e avere una lunghezza massima di 63 caratteri.
  • Le chiavi e i valori possono contenere solo lettere minuscole, caratteri numerici, trattini bassi e trattini. Tutti i caratteri devono utilizzare la codifica UTF-8 e sono consentiti i caratteri internazionali. Le chiavi devono iniziare con una lettera minuscola o internazionale.
  • La parte della chiave di un'etichetta deve essere univoca all'interno di una singola risorsa. Tuttavia, puoi utilizzare la stessa chiave con più risorse.

Questi limiti si applicano alla chiave e al valore per ciascuna etichetta e al alle singole risorse Google Cloud con etichette. Là non esiste un limite al numero di etichette che puoi applicare a tutte le risorse all'interno di un progetto.

Utilizzi comuni delle etichette

Ecco alcuni casi d'uso comuni per le etichette:

  • Etichette per team o centro di costo: aggiungi etichette in base al team o al centro di costo per distinguere le istanze Filestore di proprietà di team diversi (ad esempio team:research e team:analytics). Puoi utilizzare questo tipo di etichetta per la contabilità dei costi o la definizione del budget.

  • Etichette dei componenti: ad esempio, component:redis, component:frontend, component:ingest e component:dashboard.

  • Etichette di ambiente o fase: ad esempio, environment:production e environment:test.

  • Etichette degli stati: ad esempio state:active, state:readytodelete e state:archive.

  • Etichette di proprietà: utilizzate per identificare i team che sono responsabile delle operazioni, ad esempio: team:shopping-cart.

Sconsigliamo di creare un numero elevato di etichette univoche, ad esempio: per timestamp o singoli valori per ogni chiamata API. Il problema di questo approccio è che, quando i valori cambiano di frequente o con chiavi che ingombrano il catalogo, diventa difficile filtrare e generare report sulle risorse in modo efficace.

Etichette e tag

Le etichette possono essere utilizzate come annotazioni interrogabili per le risorse, ma non possono essere utilizzate per impostare delle condizioni sui criteri. I tag offrono un modo per consentire o di negare i criteri in base al fatto che una risorsa abbia un tag specifico, fornendo controllo sui criteri. Per ulteriori informazioni, consulta Panoramica dei tag.

Aggiunta o aggiornamento delle etichette di un'istanza

Puoi aggiungere etichette a un'istanza Filestore quando crea l'istanza. Dopo aver creato un'istanza, puoi aggiungere altre etichette, nonché aggiornare o eliminare quelle esistenti.

Console

  1. Nella console Google Cloud, vai alla pagina Istanze Filestore.

    Vai alla pagina delle istanze Filestore

  2. Seleziona la casella di controllo accanto a ogni istanza di cui vuoi modificare le etichette.

  3. Fai clic su Mostra riquadro informazioni.

  4. Aggiungi e aggiorna le etichette in base alle tue esigenze:

    Operazione Istruzioni
    Aggiungi un'etichetta Fai clic su Aggiungi etichetta e digita la chiave e il valore dell'etichetta.
    Aggiornare un'etichetta Aggiorna il campo Valore. Non puoi aggiornare la chiave di un'etichetta esistente.
    Eliminare un'etichetta Fai clic su Elimina elemento accanto all'etichetta.

  5. Fai clic su Salva per salvare le modifiche al termine degli aggiornamenti.

gcloud

Puoi modificare le etichette di un'istanza Filestore eseguendo il comando instances update. Per aggiungere nuove etichette o modificare i valori di etichette esistenti, utilizza la --update-labels flag. Per eliminare una o più etichette, utilizza --remove-labels flag. Il flag --clear-labels rimuove tutte le etichette da un'istanza.

gcloud filestore instances update instance-id \
    --project=project-id \
    --zone=zone \
    --update-labels key=value,[key=value,…] \
    --remove-labels key,[key,…] \
    --clear-labels

dove:

  • instance-id è l'ID dell'istanza da modificare.

  • project-id è l'ID del progetto Google Cloud che contiene l'istanza Filestore. Puoi saltare questo passaggio flag se l'istanza Filestore è nel valore predefinito gcloud progetto. Puoi impostare il progetto predefinito eseguendo:

     gcloud config set project project-id

  • zone è la zona in cui Filestore dell'istanza di Compute Engine. Esegui il comando gcloud filestore zones list per ottenere un elenco delle zone supportate. Puoi saltare questa segnalazione se l'istanza Filestore è nel valore predefinito gcloud zona di destinazione. Per impostare la zona predefinita, esegui:

     gcloud config set filestore/zone zone

  • key è una nuova etichetta o un'etichetta esistente da modificare o rimuovere.

  • value è il valore di un'etichetta.

Esempio

L'esempio seguente aggiorna l'istanza nfs-server aggiungendo lo status l'etichetta, aggiornando il valore dell'etichetta dept e rimuovendo l'etichetta admin.

gcloud filestore instances update nfs-server \
    --project=myproject \
    --zone=us-central1-c \
    --update-labels status=active \
    --update-labels dept=accounting \
    --remove-labels admin

Servizi che attualmente supportano le etichette

Attualmente i seguenti servizi Google Cloud supportano le etichette:

  • AI Platform
  • App Engine (ambienti flessibili e standard)
  • Artifact Registry
  • BigQuery
  • Certificate Authority Service
  • Cloud Composer
  • Bigtable
  • Cloud Deployment Manager
  • Funzioni Cloud Run
  • API Cloud Healthcare
  • Cloud Key Management Service
  • Cloud Run
  • Spanner
  • Cloud SQL
  • Cloud Storage
  • Compute Engine
  • Dataflow
  • Dataproc
  • Filestore
  • Google Kubernetes Engine
  • Networking
  • Pub/Sub
  • Resource Manager (solo progetti)

Passaggi successivi

Scopri come modificare altre proprietà di un'istanza Filestore.