为项目创建和更新标签

本文档详细介绍了如何使用 gcloud CLI、Cloud Resource Manager API 和 Google Cloud 控制台为 项目创建和更新标签。

为项目创建标签

控制台

要为单个项目添加标签，请执行以下操作：

  1. 打开 Google Cloud 控制台中的标签页面。

    打开“标签”页面

  2. 从选择项目下拉列表中选择您的项目。

  3. 要添加新标签条目，请点击 + 添加标签并为要添加的每个标签输入标签键和值。

  4. 添加完标签后，点击保存。

要同时为多个项目添加标签，请执行以下操作：

  1. 打开 Google Cloud 控制台中的管理资源 页面。

    打开“管理资源”页面

  2. 在管理资源页面中，选择要为其添加标签的项目。

  3. 在信息面板的标签标签页中，点击 + 添加标签并为要添加的每个标签输入标签键和值。

  4. 添加完标签后，点击保存。

添加了标签后，您可以对项目进行过滤，方法是在项目列表上方的过滤框中输入标签键或值。过滤框会建议键和值，以便您预览结果。

gcloud

如需使用 gcloud CLI 创建带有标签的新 项目，请使用带有 --labels 标志的 gcloud projects create 命令：

gcloud projects create PROJECT_ID \
    --labels=KEY1=VALUE1,KEY2=VALUE2

如需为现有 项目添加标签，请使用带有 --update-labels 标志的 gcloud projects update 命令：

gcloud projects update PROJECT_ID \
    --update-labels=KEY1=VALUE1,KEY2=VALUE2

其中：

  • PROJECT_ID 是您要创建或更新的项目的 ID。
  • KEY1=VALUE1 是您要添加的 标签的键值对。

REST

如需创建带有标签的新 项目，请在向 projects.create 方法发出 POST 请求时添加 labels 字段：

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "projectId": "PROJECT_ID",
    "displayName": "PROJECT_NAME",
    "labels": {
      "environment": "development"
    }
  }' \
  "https://cloudresourcemanager.googleapis.com/v3/projects"

如需为现有 项目添加标签，请使用 projects.patch 方法：

curl -X PATCH \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "labels": {
      "environment": "development"
    }
  }' \
  "https://cloudresourcemanager.googleapis.com/v3/projects/PROJECT_ID?updateMask=labels"

更新项目的标签

控制台

如需更新单个项目的标签，请执行以下操作：

  1. 打开 Google Cloud 控制台中的标签页面。

    打开“标签”页面

  2. 从选择项目下拉列表中选择您的项目。

  3. 更新项目的标签：

    1. 如需修改标签，请点击要修改的值，然后 进行所需的更改。
    2. 要删除标签，请将指针悬停在键或值上，然后点击 。

  4. 更新完标签后，点击保存。

要同时为多个项目更新标签，请执行以下操作：

  1. 打开 Google Cloud 控制台中的管理资源 页面。

    打开“管理资源”页面

  2. 在管理资源页面中，选择要为其更新标签的项目。

  3. 在信息面板中，点击标签 标签页并更新 所选项目的标签：

    1. 如需修改标签，请点击要修改的值，然后 进行所需的更改。
    2. 要删除标签，请将指针悬停在键或值上，然后点击 。

  4. 更新完标签后，点击保存 。

gcloud

如需使用 gcloud CLI 更新项目的标签，请使用带有 --update-labels、--remove-labels 或 --clear-labels 标志的 gcloud projects update 命令。

如需添加或更新标签，请执行以下操作：

gcloud projects update PROJECT_ID \
    --update-labels=KEY1=VALUE1,KEY2=VALUE2

如需移除特定标签，请执行以下操作：

gcloud projects update PROJECT_ID \
    --remove-labels=KEY1,KEY2

如需从项目中移除所有标签，请执行以下操作：

gcloud projects update PROJECT_ID \
    --clear-labels

REST

如需使用 API 更新项目的标签，请向 projects.patch 方法发送 PATCH 请求：

curl -X PATCH \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "labels": {
      "color": "red"
    }
  }' \
  "https://cloudresourcemanager.googleapis.com/v3/projects/PROJECT_ID?updateMask=labels"

其中，PROJECT_ID 是您要更新的项目的 ID。