创建和管理标签

本页面简要介绍标签,并说明如何使用 Resource Manager API 与 Google Cloud Platform Console 创建和管理标签。

什么是标签?

标签是一种键值对,可帮助您整理 Google Cloud Platform 实例。您可以将标签附加到各项资源,然后根据其标签对资源进行过滤。标签的相关信息会传递到结算系统,因此您可以根据标签来细分结算费用

标签的常见用途

以下是标签的一些常见使用场景:

  • 团队或成本中心标签:根据团队或成本中心添加标签,以区分不同团队所拥有的实例(例如 team:researchteam:analytics)。您可以在核算成本或制定预算时使用此类标签。

  • 组件标签:例如 component:rediscomponent:frontendcomponent:ingestcomponent:dashboard

  • 环境或阶段标签:例如 environment:productionenvironment:test

  • 状态标签:例如 state:activestate:readytodeletestate:archive

  • 虚拟机标签:标签可附加到虚拟机。您在过去定义的虚拟机标记将显示为没有值的标签。

标签要求

应用于资源的标签必须符合以下要求:

  • 每项资源可以有多个标签,但不能超过 64 个。
  • 每个标签都必须采用键值对形式。
  • 键至少有 1 个字符,最多有 63 个字符,且不能为空。值可以为空,且最多有 63 个字符。
  • 键和值只能包含小写字母、数字字符、下划线和短划线。所有字符必须使用 UTF-8 编码,并且允许使用国际字符。
  • 标签的键部分必须是唯一的。但是,您可以将同样的键用于多个资源。
  • 键必须以小写字母或国际字符开头。

对于给定的报告服务和项目,将在一小时内保留的不同键值对组合的数量为 1000 个。例如,Compute Engine 服务会报告虚拟机 (VM) 实例中的指标。如果您部署了一个具有 2000 个虚拟机的项目,且每个虚拟机的标签都各不相同,则系统只会保留 1 小时内存在的前 1000 个标签的服务报告指标。

使用 Resource Manager API 创建和管理标签

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

REST

请求:

POST https://cloudresourcemanager.googleapis.com/v1beta1/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",
}

Python

...

  project = crm.projects().create(
    body={
        'project_id': flags.projectId,
        'name': 'myproject',
        labels.color: "red"
}).execute()

...


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

  • 使用 get() 方法获取项目。
  • 修改 label 字段。
  • 使用 update() 方法更新项目。

如需详细了解如何更新项目的标签,请参阅更新项目

如需详细了解如何使用标签过滤项目,请参阅列出项目

使用 GCP Console 创建和管理标签

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

  1. 在 GCP Console 中打开标签页面。
    打开“标签”页面
  2. 选择项目下拉列表中选择您的项目。
  3. 要添加新标签条目,请点击 + 添加标签并为要添加的每个标签输入标签键和值。
  4. 添加完标签后,点击保存

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

  1. 在 GCP Console 中打开管理资源页面。
    打开“管理资源”页面
  2. 管理资源页面中,选择要为其添加标签的组织和项目。
  3. 在右侧面板的标签标签中,点击 + 添加标签并为要添加的每个标签输入标签键和值。
  4. 添加完标签后,点击保存

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

目前支持标签的服务

现在,下列 GCP 服务支持标签:

  • BigQuery
  • Cloud Bigtable
  • Cloud Dataflow
  • Cloud Dataproc
  • Cloud Deployment Manager
  • Cloud Functions
  • Cloud Key Management Service
  • Cloud Pub/Sub
  • Cloud Spanner
  • Cloud SQL
  • Cloud Storage
  • Compute Engine
  • Google Kubernetes Engine
  • 网络
  • Resource Manager
此页内容是否有用?请给出您的反馈和评价:

发送以下问题的反馈:

此网页
Resource Manager 文档