什么是标签?
标签是一种键值对,可分配给 Google Cloud 实例。它们可以帮助您按照所需的粒度大规模组织这些资源并管理费用。您可以将标签附加到各项资源,然后根据其标签对资源进行过滤。标签的相关信息会转发到结算系统,以便您按标签细分结算费用。使用内置的结算报告,您可以按资源标签对费用进行过滤和分组。您还可以使用标签查询结算数据导出。
标签要求
应用于资源的标签必须符合以下要求:
- 每个资源最多可以有 64 个标签。
- 每个标签都必须采用键值对形式。
- 键至少包含 1 个字符,最多包含 63 个字符,且不能为空。值可以为空,且最多包含 63 个字符。
- 键和值只能包含小写字母、数字字符、下划线和短划线。所有字符必须使用 UTF-8 编码,允许使用国际字符。 键必须以小写字母或国际字符开头。
- 标签的键部分在单个资源内必须是唯一的。不过,您可以将同一个键用于多个资源。
这些限制适用于每个标签的键和值,以及带有标签的各个 Google Cloud 资源。您可以对一个项目的所有资源应用任意数量的标签。
标签的常见用途
以下是标签的一些常见使用场景:
团队或成本中心标签:根据团队或成本中心添加标签,以区分不同团队所拥有的实例(例如
team:research
和team:analytics
)。您可以在核算成本或制定预算时使用此类标签。组件标签:例如
component:redis
、component:frontend
、component:ingest
和component:dashboard
。环境或阶段标签:例如
environment:production
和environment:test
。状态标签:例如
state:active
、state:readytodelete
、state:archive
。所有权标签:用于标识负责运营的团队,例如:
team:shopping-cart
。
+ 虚拟机标签:标签可附加到虚拟机。您在过去定义的虚拟机标记显示为没有值的标签。
我们不建议创建大量唯一标签,例如为每个 API 调用的时间戳或个别值创建标签。这种方法的问题在于,当值经常变化或键导致目录杂乱时,很难有效地过滤和报告资源。
标签和标记
标签可用作资源可查询的注释,但不能用于设置政策的条件。通过对政策进行精细控制,标记提供了一种有条件地允许或拒绝政策的方法,具体取决于资源是否具有特定的标记。如需了解详情,请参阅标记概览。
如需详细了解 Google Cloud 标签,请参阅使用标签整理资源。
Cloud Workstations 资源标签
Cloud Workstations 会自动将以下标签应用于所有资源:
workstation_cluster_id
workstation_config_id
workstation_id
workstation_location
goog-drz-workstation-location
goog-drz-workstation-uuid
goog-workstations
自定义 Cloud Workstations 标签
您还可以向工作站集群、工作站配置和工作站添加自定义标签,系统会递归地将这些标签应用于所有底层 Compute Engine 资源,但不会应用于底层 Cloud Workstations API 资源。如需为单个工作站标记 Compute Engine 资源,请务必为每个单独的工作站添加标签。
调用 Cloud Workstations API 时,请使用 labels
字段。
例如,在以下示例 config.json
文件中,webserver
是键,backend
是相应的值。同样,media
是键,images
是相应的值。
{
"idleTimeout": "7200s",
"host": {
"gce_instance": {
"machine_type": "e2-standard-8",
"pool_size": 1
}
},
"persistentDirectories": [
{
"mountPath": "/home",
"gcePd": {
"sizeGb": 200,
"fsType": "ext4"
}
}
],
"labels": {
"webserver": "backend",
"media": "images"
}
}