为项目创建和更新标签

本文档详细介绍了如何使用 Resource Manager API 和 Google Cloud 控制台创建和更新项目标签。该指南详细介绍了如何使用标签以及支持标签的服务来了解费用。

为项目创建标签

控制台

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

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

    打开“标签”页面

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

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

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

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

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

    打开“管理资源”页面

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

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

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

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

REST

要创建带有标签的新项目，请在创建项目时设置 labels 字段。

请求：

POST https://cloudresourcemanager.googleapis.com/v3/projects

{
 "labels": {
  "color": "red"
 },
 "name": "myproject",
 "projectId": "our-project-123"
}

响应：


{
 "projectNumber": "333197460082",
 "projectId": "our-project-123",
 "lifecycleState": "ACTIVE",
 "name": "myproject",
 "labels": {
  "color": "red"
 },
 "createTime": "2016-01-12T22:18:28.633Z",
}

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

添加标签后，您可以根据标签过滤项目。如需详细了解如何使用标签过滤项目，请参阅列出项目。

更新项目的标签

控制台

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

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

    打开“标签”页面

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

  3. 更新项目的标签：

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

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

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

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

    打开“管理资源”页面

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

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

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

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

REST

要更新项目的标签，请执行以下操作：

  • 使用 projects.get() 方法获取 project 对象。

  • 修改要更新的标签。

  • 调用 projects.patch 方法。

以下示例会更新标签 color:blue：

以下代码段会将 color 标签的值从 blue 更改为 red。

请求：

PATCH https://cloudresourcemanager.googleapis.com/v3/projects/PROJECT_NAME
{
  updateMask=labels
}

其中，PROJECT_NAME 是要更新的项目的名称。

请求 JSON 正文：

{
    "labels":
      {
        "color": "red"
      }
}

响应：

{
    "projects": [
    {
        "name": "projects/123456789012",
        "parent": "folders/123456789012",
        "projectId": "my-project",
        "state": "ACTIVE",
        "displayName": "PROJECT_NAME"
        "createTime": "2013-11-13T20:31:53.308Z"
        "updateTime": "2013-11-13T20:35:42.308Z"
        "etag": "BwWUlZ6XEfY="
        "labels": {
            "color": "red"
        },
    }
    ]
}