Gestione delle etichette

Questa pagina mostra come utilizzare le etichette con Filestore di Compute Engine. 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 collegare un'etichetta a ogni risorsa, quindi filtrare a risorse in base alle loro etichette. Le informazioni sulle etichette vengono inoltrate al sistema di fatturazione che consente di suddividere gli addebiti fatturati per etichetta. Grazie ai report sulla fatturazione integrati, puoi filtrare e raggruppare i costi per 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 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 del team o del centro di costo: aggiungi etichette in base al team o per distinguere le istanze Filestore di proprietà di team (ad es. team:research e team:analytics). Puoi utilizzare questo tipo di etichetta per la contabilizzazione dei costi o la definizione del budget.

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

  • Etichette dell'ambiente o della 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 spesso o con che ingombrano il catalogo, rendendo difficile l'applicazione di filtri e e creare report sulle risorse.

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 all'istanza, aggiornare o eliminare le etichette 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. Una volta terminate le modifiche, fai clic su Salva per salvare le modifiche aggiornamenti.

gcloud

Puoi modificare le etichette di un'istanza Filestore eseguendo il comando 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 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. Puoi impostare la zona predefinita eseguendo:

     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 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

I servizi che attualmente supportano le etichette

Attualmente i seguenti servizi Google Cloud supportano le etichette:

  • AI Platform
  • App Engine (ambiente flessibile 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 file Filestore in esecuzione.