配置标签

Cloud Run 标签是应用于 Cloud Run 作业的键值对。本页介绍如何设置、修改和删除 Cloud Run 作业的标签。

可能的用途包括：

用于费用分配和账单明细。
确定各个团队或费用中心使用的资源。
区分部署环境（生产、预演、质量检查或测试）。
识别所有者、状态标签。
在 Logging 中过滤日志。

标签使用规则

以下规则适用于使用在 Cloud Run 作业上设置的标签：

只允许在 Cloud Run 上使用有效的 Google Cloud 标签。

所需的角色

如需获得配置 Cloud Run 作业所需的权限，请让管理员向您授予以下 IAM 角色：

Cloud Run 作业的 Cloud Run Developer (roles/run.developer) 角色
服务身份的 Service Account User (roles/iam.serviceAccountUser) 角色

如需查看与 Cloud Run 关联的 IAM 角色和权限的列表，请参阅 Cloud Run IAM 角色和 Cloud Run IAM 权限。如果您的 Cloud Run 作业与 Google Cloud API（例如 Cloud 客户端库）进行交互，请参阅服务身份配置指南。如需详细了解如何授予角色，请参阅部署权限和管理访问权限。

设置或修改标签

您可以使用 Google Cloud CLI 或 YAML 在 Cloud Run 作业上设置标签。

命令行

如需在新作业上设置标签，请运行以下命令：
```
gcloud run jobs create JOB_NAME --image IMAGE_URL --labels KEY=VALUE
```
替换
- 将 JOB_NAME 替换为作业的名称。
- 将 KEY 替换为您的标签键的名称
- 将 VALUE 替换为键的值
- 将 IMAGE_URL 替换为对容器映像的引用，例如 us-docker.pkg.dev/cloudrun/container/job:latest。
如需在现有作业上设置标签，请运行以下命令：
```
gcloud run jobs update JOB_NAME --labels KEY=VALUE
```
如需创建多个标签，请提供以英文逗号分隔的键值对列表。
```
gcloud run jobs update JOB_NAME --labels KEY1=VALUE1,KEY2=VALUE2 
```

YAML

使用 gcloud run jobs describe --format export 命令下载并查看现有作业配置，该命令会生成清理后的 YAML 格式的结果。然后，修改下述字段，并使用 gcloud run jobs replace 命令上传修改后的 YAML。请务必严格按照说明修改字段。

要查看和下载配置，请运行以下命令：

gcloud run jobs describe JOB_NAME --format export > job.yaml

在两个位置更新 labels 特性：
```
apiVersion: run.googleapis.com/v1
kind: Job
metadata:
  labels:
    LABEL: VALUE
spec:
  template:
    metadata:
      labels:
        LABEL: VALUE
```
替换
- 将 LABEL 替换为标签的名称
- 将 VALUE 替换为所需的值
您还可以指定更多配置，例如环境变量或内存限制。
更新现有作业配置：
```
gcloud run jobs replace job.yaml
```

按标签列出作业

您可以使用 Google Cloud CLI 过滤条件按标签列出作业：

  gcloud run jobs list --filter metadata.labels.LABEL=VALUE

您需要将其中的：

将 LABEL 替换为标签的名称
将 VALUE 替换为要包含在过滤列表中的值

删除作业上的标签

如需清除服务的所有标签，请使用以下命令：

gcloud run jobs update JOB --clear-labels

如需删除服务的特定标签，请提供以英文逗号分隔的键列表：

gcloud run jobs update JOB --remove-labels LABEL

替换

将 JOB 替换为 Cloud Run 作业的名称
将 LABEL 替换为您的标签名称