Tags an Cloud SQL-Instanzen anhängen und verwalten

Auf dieser Seite wird beschrieben, wie Sie Tags an Cloud SQL-Instanzen anhängen, trennen und auflisten. Eine Übersicht über Tags in Cloud SQL finden Sie unter Zugriffssteuerung mit Google Cloud-Tags.

Hinweis

Tags werden über den Resource Manager verwaltet. Sie benötigen die folgenden Cloud SQL-IAM-Berechtigungen, um Tags auf Cloud SQL-Instanzen aufzurufen und festzulegen:

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

Die Berechtigungen für cloudsql werden über die IAM-Rolle cloudsql.admin übernommen. resourcemanager.tagUser ist erforderlich, um eine Instanz bei der Erstellung zu taggen.

Cloud SQL-Instanz mit einem Tag erstellen

Wenn Sie eine Instanz mit einem angehängten Tag erstellen möchten, verwenden Sie beim Erstellen der Instanz das Flag --tags. Dabei werden die Tags mit Organisationsrichtlinien, benutzerdefinierten Organisationsrichtlinien und IAM-Bedingungen kombiniert, um die Richtlinien für die Instanzerstellung besser anpassen zu können.

Mit dem folgenden Befehl wird beispielsweise in der gcloud CLI eine Instanz mit dem Tag 1234 und dem Wert 5678 erstellt.[gcloud sql instances create tags-instance --tags=tagKeys/1234=tagValues/5678]

Tags an Cloud SQL-Instanzen anhängen

Nachdem Sie mit Resource Manager ein Tag erstellt und definiert haben, können Sie es an eine Cloud SQL-Instanz anhängen. Wenn Sie ein Tag an eine Cloud SQL-Instanz anhängen möchten, erstellen Sie eine Tag-Bindung. Führen Sie dazu den Befehl gcloud resource-manager tags bindings create aus:

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

Ersetzen Sie im vorherigen Befehl Folgendes:

  • TAG_VALUE_ID: die permanente ID oder der Namespace-Name des Tag-Werts. Beispiel: tagValues/4567890123 oder 12345678/environment/production. Weitere Informationen zu Tag-IDs finden Sie unter Tag-Definitionen und Kennzeichnungen.

  • PARENT: der vollständige Ressourcenname der Cloud SQL-Instanz, an die das Tag angehängt werden soll. Beispiel: //sqladmin.googleapis.com/projects/my-project/instances/my-instance

  • LOCATION: Der regionale Standort der Cloud SQL-Ressource. Beispiel: us-central1.

Tags von Cloud SQL-Instanzen trennen

Mit dem Befehl gcloud resource-manager tags bindings delete wird das Tag von my-instance getrennt:

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

Tags für Cloud SQL-Instanzen auflisten

Mit dem Befehl gcloud resource-manager tags bindings list werden alle Tags aufgelistet, die direkt an my-instance angehängt sind, mit Ausnahme der Tags, die my-instance übernommen hat:

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

Nächste Schritte