This page describes how to attach, detach, and list tags on Dataproc Metastore resources. For an overview of tags on Dataproc Metastore, see Organize Dataproc Metastore resources using tags.
Before you begin
To get the permissions that you need to view and set tags on Dataproc Metastore resources, ask your administrator to grant you the following IAM roles on your project:
-
Dataproc Metastore Editor (
roles/metastore.editor
): assign to set and view tags -
Dataproc Metastore Viewer (
roles/metastore.viewer
): assign to view tags
For more information about granting roles, see Manage access to projects, folders, and organizations.
You might also be able to get the required permissions through custom roles or other predefined roles.
Work with tags
After you've created and defined a tag using Resource Manager, you can start using tags with Dataproc Metastore service and federation resources. For more information about the Google Cloud CLI commands to use tag bindings, see gcloud resource-manager tags bindings.
For all of the commands on this page, replace the following:
PARENT_PATH
: The complete path to the service or federation resource—for example,//metastore.googleapis.com/projects/my-project/locations/us-central1/services/my-service
.TAG_VALUE
: The tag value that you want to attach to your resource—for example, the tag value set as815471563813/environment/development
includes the following components:815471563813
is the organization ID or your project ID.environment
is the tag key.development
is the tag value.
LOCATION
: The region where your service or federation is located—for example,us-central1
.
Attach tags to Dataproc Metastore resources
gcloud resource-manager tags bindings create \ --parent=PARENT_PATH \ --tag-value=TAG_VALUE \ --location=LOCATION
Detach tags from Dataproc Metastore resources
gcloud resource-manager tags bindings delete \ --parent=PARENT_PATH \ --tag-value=TAG_VALUE \ --location=LOCATION
List tags on Dataproc Metastore resources
gcloud resource-manager tags bindings list \ --parent=PARENT_PATH \ --location=LOCATION