Gestione delle etichette

Questa pagina mostra come utilizzare le etichette con le istanze Filestore. Descrive inoltre come aggiungere, aggiornare ed eliminare le etichette per un'istanza. Le etichette consentono di raggruppare le istanze correlate e di archiviare i metadati relativi a un'istanza.

Cosa sono le etichette?

Un'etichetta è una coppia chiave-valore che puoi assegnare alle istanze Google Cloud Filestore. Ti 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, quindi filtrare le risorse in base alle etichette. Le informazioni sulle etichette vengono inoltrate al sistema di fatturazione, in modo da poter 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 anche utilizzare le etichette per eseguire query sulle esportazioni dei dati di fatturazione.

Requisiti per le etichette

Le etichette applicate a una risorsa devono soddisfare i seguenti 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 caratteri e non possono essere vuote. I valori possono essere vuoti e hanno 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 un carattere 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 di ogni etichetta e alle singole risorse Google Cloud che contengono etichette. Non esiste un limite al numero di etichette che puoi applicare a tutte le risorse all'interno di un progetto.

Utilizzi comuni delle etichette

Di seguito sono riportati alcuni casi d'uso comuni delle etichette:

Etichette del team o del 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 il 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 di stato: ad esempio, state:active, state:readytodelete e state:archive.
Etichette di proprietà: utilizzate per identificare i team responsabili delle operazioni, ad esempio team:shopping-cart.

Non è consigliabile creare un numero elevato di etichette univoche, ad esempio per timestamp o valori singoli per ogni chiamata API. Il problema di questo approccio è che, quando i valori cambiano spesso o con chiavi che ingombrano il catalogo, è 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 per impostare le condizioni dei criteri. I tag forniscono un modo per consentire o negare in modo condizionale i criteri a seconda che una risorsa abbia un tag specifico, fornendo un controllo granulare sui criteri. Per ulteriori informazioni, consulta la Panoramica dei tag.

Aggiunta o aggiornamento delle etichette di un'istanza

Puoi aggiungere etichette a un'istanza di Filestore quando crei l'istanza. Dopo aver creato un'istanza, puoi aggiungere altre etichette all'istanza, nonché aggiornare o eliminare le etichette esistenti.

Console

Nella console Google Cloud, vai alla pagina Istanze Filestore.

Vai alla pagina Istanze Filestore
Seleziona la casella di controllo accanto a ciascuna istanza di cui vuoi modificare le etichette.
Fai clic su Mostra riquadro informazioni.

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

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 delle etichette esistenti, utilizza il flag --update-labels. Per eliminare una o più etichette, utilizza il flag --remove-labels. 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 istanza dell'istanza da modificare.
project-id è l'ID del progetto Google Cloud che contiene l'istanza Filestore. Puoi saltare questo flag se l'istanza Filestore si trova nel progetto predefinito gcloud. Puoi impostare il progetto predefinito eseguendo:
```
 gcloud config set project project-id
```
zone è la zona in cui si trova l'istanza Filestore. Esegui il comando gcloud filestore zones list per visualizzare un elenco delle zone supportate. Puoi saltare questo flag se l'istanza di Filestore si trova nella zona predefinita di gcloud. Puoi impostare la zona predefinita eseguendo:
```
 gcloud config set filestore/zone zone
```
key è una nuova etichetta o un'etichetta esistente che vuoi modificare o rimuovere.
value è il valore di un'etichetta.

Esempio

L'esempio seguente aggiorna l'istanza nfs-server aggiungendo l'etichetta 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

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
Cloud Functions
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.