Access control with Google Cloud tags

This page describes Google Cloud tags and how to use them with Cloud SQL. To add tags to your Cloud SQL instances using gcloud now, see Attach and manage tags on Cloud SQL instances. To add tags to your Cloud SQL instances using the Google Cloud console now, see Create and manage tags on your instance.


Google Cloud tags are a way to organize your Cloud SQL resources.

Tags are applied at higher levels of the resource hierarchy across Google Cloud. Cloud SQL and other instances inherit the tags. They are managed using Resource Manager. You can add a reference to tags in IAM policy bindings to grant conditional access to resources.

Tags are different from labels, which are another way to organize and filter your instances. Tags and labels work independently of each other, and you can use both on the same instance. For more information about using labels in Cloud SQL, see Label instances.

What are tags?

Tags are key-value pairs you can apply to your resources for fine-grained access control.

A tag key could be a property, such as environment, and the tag value could be an attribute, such as development or production. A tag can have only one value for a given key on a particular resource.

Tags are created at the Organization level. Tags are attached to resources, such as a project or a Cloud SQL instance, through the Resource Manager, which is used across Google Cloud.

Grant permissions based on conditional tag bindings

Once a tag is attached to or inherited by a Cloud SQL instance, you can use the tag with IAM Conditions to grant access to Cloud SQL resources conditionally. IAM Conditions let you impose fine-grain access control to Cloud SQL instances. To use IAM Conditions, you reference the tags in IAM policy bindings. For more information on how to use tags to grant conditional access to Cloud SQL instances, see Use IAM conditions.


Tags have the following restrictions:

  • Organization policies can conditionally reference tags inherited from the Project level and above, but don't support tags that are directly attached to Cloud SQL instances.
  • Cloud Audit logs show the creation and deletion of tags, but entries are not generated for attaching tags and viewing tag bindings on Cloud SQL instances.

What's next