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
eteam: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
ecomponent:dashboard
.Etichette dell'ambiente o della fase: ad esempio,
environment:production
eenvironment:test
.Etichette di stato: ad esempio,
state:active
,state:readytodelete
estate: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.
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 delete 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 digcloud
. 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.