Associare e gestire i tag nelle istanze Cloud SQL

Questa pagina descrive come collegare, scollegare ed elencare i tag nelle istanze Cloud SQL. Per una panoramica dei tag su Cloud SQL, consulta Controllo degli accessi con i tag Google Cloud.

Prima di iniziare

I tag vengono gestiti tramite Resource Manager. Per creare e definire i tag prima di collegarli alle istanze Cloud SQL, consulta Creazione e gestione dei tag.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per visualizzare e gestire i tag nelle istanze Cloud SQL, chiedi all'amministratore di concederti i seguenti ruoli IAM:

  • Gestisci le istanze Cloud SQL e le associazioni dei tag: Cloud SQL Admin (roles/cloudsql.admin) sul progetto
  • Associa e scollega i tag alle istanze Cloud SQL: Tag User (roles/resourcemanager.tagUser) nel valore del tag e nel progetto
  • Visualizza ed elenca i tag nelle istanze Cloud SQL: Tag Viewer (roles/resourcemanager.tagViewer) nel progetto

Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questi ruoli predefiniti contengono le autorizzazioni necessarie per visualizzare e gestire i tag nelle istanze Cloud SQL. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per visualizzare e gestire i tag nelle istanze Cloud SQL sono necessarie le seguenti autorizzazioni:

  • Crea un'istanza con un tag collegato:
    • cloudsql.instances.create
    • cloudsql.instances.createTagBinding
    • resourcemanager.tagValueBindings.create
  • Collega un tag a un'istanza:
    • cloudsql.instances.createTagBinding
    • resourcemanager.tagValueBindings.create
  • Scollega un tag da un'istanza:
    • cloudsql.instances.deleteTagBinding
    • resourcemanager.tagValueBindings.delete
  • Elenca i tag di un'istanza:
    • cloudsql.instances.listTagBindings
    • cloudsql.instances.listEffectiveTags
    • resourcemanager.tagKeys.get
    • resourcemanager.tagKeys.list
    • resourcemanager.tagValues.get
    • resourcemanager.tagValues.list

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Crea un'istanza Cloud SQL con un tag

Per creare un'istanza con un tag collegato, utilizza il flag --tags durante la creazione dell'istanza. In questo modo, i tag vengono combinati con le policy dell'organizzazione, le policy dell'organizzazione personalizzate e le condizioni IAM per offrire una maggiore personalizzazione delle policy di creazione delle istanze.

Ad esempio, il seguente comando crea un'istanza in gcloud CLI con il tag 1234 con un valore di 5678 [gcloud sql instances create tags-instance --tags=tagKeys/1234=tagValues/5678]

Collega tag alle istanze Cloud SQL

Dopo aver creato e definito un tag utilizzando Resource Manager, puoi collegarlo a un'istanza Cloud SQL. Per collegare un tag a un'istanza Cloud SQL, crea un'associazione tag eseguendo il comando gcloud resource-manager tags bindings create:

gcloud resource-manager tags bindings create \
--tag-value=TAG_VALUE_ID \
--parent=PARENT \
--location=LOCATION

Nel comando precedente, effettua le seguenti sostituzioni:

  • TAG_VALUE_ID: l'ID permanente o il nome con spazio dei nomi del valore del tag. Ad esempio, tagValues/4567890123 o 12345678/environment/production. Per saperne di più sugli identificatori dei tag, consulta Definizioni e identificatori dei tag.

  • PARENT: il nome completo della risorsa dell'istanza Cloud SQL a cui collegare il tag. Ad esempio, //sqladmin.googleapis.com/projects/my-project/instances/my-instance.

  • LOCATION: la località regionale della risorsa Cloud SQL. Ad esempio, us-central1.

Scollega i tag dalle istanze Cloud SQL

Il comando gcloud resource-manager tags bindings delete scollega il tag da my-instance:

gcloud resource-manager tags bindings delete \
--tag-value=815471563813/environment/development \
--parent=//sqladmin.googleapis.com/projects/my-project/instances/my-instance \
--location=us-central1

Elenca i tag nelle istanze Cloud SQL

Il comando gcloud resource-manager tags bindings list elenca tutti i tag collegati direttamente a my-instance, ad eccezione dei tag ereditati da my-instance:

gcloud resource-manager tags bindings list \
    --parent=//sqladmin.googleapis.com/projects/my-project/instances/my-instance \
    --location=us-central1

Passaggi successivi