Tags are key-value pairs you can apply to your jobs for fine-grained access
control. Tag administrators create tags for resources across
Google Cloud at the organization or project level and manage them in
[Resource Manager](https://docs.cloud.google.com/resource-manager/docs/tags/tags-creating-and-managing.md.txt).
Tags provides a way to conditionally allow or deny
policies based on whether a resource has a specific tag.

> [!NOTE]
> **Note:** In contrast to tags, [labels](https://docs.cloud.google.com/run/docs/configuring/jobs/labels.md.txt) are used to identify resources for billing-related reasons, filtering logs, and so forth.

## Required roles


To get the permissions that
you need to attach or detach tags,

ask your administrator to grant you the
following IAM roles on the Cloud Run job:

- [Cloud Run Admin](https://docs.cloud.google.com/iam/docs/roles-permissions/run.md.txt#run.admin) (`roles/run.admin`)
- [Tag User](https://docs.cloud.google.com/iam/docs/roles-permissions/resourcemanager.md.txt#resourcemanager.tagUser) (`roles/resourcemanager.tagUser`)


To manage access on the tag value resource in Resource Manager, your
account must also have the
[Tag User](https://docs.cloud.google.com/iam/docs/roles-permissions/resourcemanager.md.txt#resourcemanager.tagUser) (`roles/resourcemanager.tagUser`) role
[granted for the tag value](https://docs.cloud.google.com/resource-manager/docs/tags/tags-creating-and-managing.md.txt#managing_access).
The tag value is the resource that is attached to the Cloud Run
job.

For a list of IAM roles and permissions that are associated with
Cloud Run, see
[Cloud Run IAM roles](https://docs.cloud.google.com/run/docs/reference/iam/roles.md.txt)
and [Cloud Run IAM permissions](https://docs.cloud.google.com/run/docs/reference/iam/permissions.md.txt).
If your Cloud Run job interfaces with
Google Cloud APIs, such as Cloud Client Libraries, see the
[service identity configuration guide](https://docs.cloud.google.com/run/docs/configuring/jobs/service-identity.md.txt).
For more information about granting roles, see
[deployment permissions](https://docs.cloud.google.com/run/docs/reference/iam/roles.md.txt#additional-configuration)
and [manage access](https://docs.cloud.google.com/iam/docs/granting-changing-revoking-access.md.txt).

## Attaching tags

Attach tags using the Google Cloud CLI.

### gcloud

Update tags for a job using the command:

```bash
gcloud resource-manager tags bindings create \
    --tag-value=TAG_VALUE \
    --parent=//run.googleapis.com/projects/PROJECT_ID/locations/REGION/jobs/JOB \
    --location=REGION
```

To update more than one tag, supply a comma delimited list of key/value
pairs.

Replace

- <var translate="no">TAG_VALUE</var> with the value for the key. You can use these different types of identifiers: a permanent ID such as `tagValues/12345678901`, a namespaced value such as `123456789012/env/prod` or a short name such as `prod`
- <var translate="no">PROJECT_ID</var> with project ID of your Google Cloud project
- <var translate="no">REGION</var> with region your Cloud Run job is deployed to
- <var translate="no">JOB</var> with name of your Cloud Run job

## Detaching a tag

Use the Google Cloud CLI to detach tags from your job.

### gcloud

To detach a tag from a job:

```bash
gcloud resource-manager tags bindings delete \
    --tag-value=TAG_VALUE \
    --parent=//run.googleapis.com/projects/PROJECT_ID/locations/REGION/jobs/JOB \
    --location=REGION
```

To detach more than one tag, supply a comma delimited list of key/value
pairs.

Replace

- <var translate="no">TAG_VALUE</var> with the value for the key: you can use these different types of identifiers: a permanent ID such as `tagValues/12345678901`, a namespaced value such as `123456789012/env/prod` or a short name such as `prod`
- <var translate="no">PROJECT_ID</var> with project ID of your Google Cloud project
- <var translate="no">REGION</var> with region your Cloud Run job is deployed to
- <var translate="no">JOB</var> with name of your Cloud Run job