Cosa sono le etichette?
Un'etichetta è una coppia chiave-valore che puoi assegnare alle istanze Google Cloud. 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 per etichette delle risorse. Puoi utilizzare le etichette anche 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 può essere vuota. 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 un carattere internazionale.
- La parte relativa alla 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 con 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 basate sul team o sul centro di costo per distinguere le istanze 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 del componente: ad esempio
component:redis
,component:frontend
,component:ingest
ecomponent:dashboard
.Etichette dell'ambiente o della fase: ad esempio,
environment:production
eenvironment:test
.Etichette 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
.
+ Etichette di macchine virtuali: un'etichetta può essere collegata a una macchina virtuale. I tag di macchine virtuali che hai definito in passato vengono visualizzati come etichetta senza valore.
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 possono essere utilizzate 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.
Per ulteriori informazioni sulle etichette Google Cloud, consulta Organizzare le risorse utilizzando le etichette.
Etichette delle risorse Cloud Workstations
Cloud Workstations applica automaticamente le seguenti etichette a tutte le risorse:
workstation_cluster_id
workstation_config_id
workstation_id
workstation_location
goog-drz-workstation-location
goog-drz-workstation-uuid
goog-workstations
Etichette personalizzate Cloud Workstations
Puoi anche aggiungere le tue etichette personalizzate a cluster di workstation, configurazioni di workstation e workstation, in modo da applicarle in modo ricorsivo a tutte le risorse Compute Engine sottostanti, anche se non alle risorse dell'API Cloud Workstations sottostanti. Per etichettare le risorse Compute Engine per le singole workstation, assicurati di aggiungere etichette per ogni singola workstation.
Utilizza il campo labels
quando chiami
l'API Cloud Workstations.
Ad esempio, nel file config.json
di esempio che segue, webserver
è una chiave e backend
è il valore corrispondente. Analogamente, media
è una chiave e images
è il valore corrispondente.
{
"idleTimeout": "7200s",
"host": {
"gce_instance": {
"machine_type": "e2-standard-8",
"pool_size": 1
}
},
"persistentDirectories": [
{
"mountPath": "/home",
"gcePd": {
"sizeGb": 200,
"fsType": "ext4"
}
}
],
"labels": {
"webserver": "backend",
"media": "images"
}
}