Etichetta le risorse Cloud Workstations

Questa pagina descrive come utilizzare le etichette con le risorse Cloud Workstations.

Cosa sono le etichette?

Un'etichetta è una coppia chiave-valore che puoi assegnare alle istanze Google Cloud. 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 relative alle 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 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 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. 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 basate su team o centro di costo per distinguere le istanze 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 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.

+ Etichette delle macchine virtuali: un'etichetta può essere collegata a una macchina virtuale. I tag delle macchine virtuali che hai definito in passato vengono visualizzati come etichetta senza un valore.

Nota: non includere informazioni sensibili nelle etichette, ad esempio: informazioni che consentono l'identificazione personale, come il nome o la qualifica di un individuo. Le etichette non sono progettate per gestire informazioni sensibili.

Non è consigliabile creare un numero elevato di etichette univoche, ad esempio per i timestamp o i 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 forniscono un modo per consentire o negare in modo condizionale i criteri a seconda che una risorsa abbia un tag specifico, offrendo un controllo granulare sui criteri. Per ulteriori informazioni, consulta la panoramica dei tag.

Per saperne di più sulle etichette di Google Cloud, vedi Organizzare le risorse utilizzando 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 di Cloud Workstations

Puoi anche aggiungere le tue etichette personalizzate ai cluster di workstation, alle configurazioni delle workstation e alle workstation, che le applicano 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 singole workstation, assicurati di aggiungere etichette per ogni singola workstation.

Utilizza il campo labels quando chiami il metodo API Cloud Workstations.

Ad esempio, nel seguente file config.json di esempio, webserver è una chiave e backend è il valore corrispondente. Analogamente, media è una chiave 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"
      }
    }