Associer et gérer des tags sur des instances Cloud SQL

Cette page explique comment associer, dissocier et répertorier des tags sur des instances Cloud SQL. Pour obtenir une présentation des tags sur Cloud SQL, consultez la section Contrôle des accès avec des tags Google Cloud.

Avant de commencer

Les tags sont gérés via Resource Manager. Vous devez disposer des autorisations IAM Cloud SQL suivantes pour afficher et définir des tags sur des instances Cloud SQL :

  • cloudsql.instances.createTagBinding
  • cloudsql.instances.deleteTagBinding
  • cloudsql.instances.listTagBindings
  • resourcemanager.tagUser

Les autorisations cloudsql sont héritées via le rôle IAM cloudsql.admin. L'interface resourcemanager.tagUser est requise pour taguer une instance lors de sa création.

Créer une instance Cloud SQL avec un tag

Pour créer une instance avec un tag associé, utilisez l'option --tags lors de la création de l'instance. Cela combine les tags avec les règles d'administration, les règles d'administration personnalisées et les conditions IAM pour offrir une plus grande personnalisation des règles de création d'instances.

Par exemple, la commande suivante crée une instance dans la gcloud CLI avec le tag 1234 et la valeur 5678 [gcloud sql instances create tags-instance --tags=tagKeys/1234=tagValues/5678].

Associer des tags à des instances Cloud SQL

Une fois que vous avez créé et défini un tag à l'aide de Resource Manager, vous pouvez l'associer à une instance Cloud SQL. Pour associer un tag à une instance Cloud SQL, créez une liaison de tag en exécutant la commande gcloud resource-manager tags bindings create :

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

Dans la commande précédente, remplacez les éléments suivants :

  • TAG_VALUE_ID : ID permanent ou nom de l'espace de noms de la valeur du tag. Par exemple, tagValues/4567890123 ou 12345678/environment/production. Pour en savoir plus sur les identifiants de tag, consultez Définitions et identifiants de tags.

  • PARENT : nom complet de la ressource de l'instance Cloud SQL à laquelle associer le tag. Exemple : //sqladmin.googleapis.com/projects/my-project/instances/my-instance.

  • LOCATION : emplacement régional de la ressource Cloud SQL. Exemple :us-central1

Dissocier des tags des instances Cloud SQL

La commande gcloud resource-manager tags bindings delete dissocie le tag de 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

Répertorier les tags sur des instances Cloud SQL

La commande gcloud resource-manager tags bindings list répertorie tous les tags directement associés à my-instance, à l'exception des tags hérités par my-instance :

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

Étapes suivantes