管理标签

本页面介绍如何将标签用于 Filestore 实例。同时还介绍了如何添加、更新和删除实例的标签。通过标签，您可以对相关实例进行分组以及存储实例的相关元数据。

什么是标签？

标签是一种键值对，可分配给 Google Cloud Filestore 实例。它们可以帮助您按照所需的粒度大规模组织这些资源并管理费用。您可以将标签附加到各项资源，然后根据其标签对资源进行过滤。标签的相关信息会转发到结算系统，以便您按标签细分结算费用。使用内置的结算报告，您可以按资源标签对费用进行过滤和分组。您还可以使用标签查询结算数据导出。

标签要求

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

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

这些限制适用于每个标签的键和值，以及带有标签的各个 Google Cloud 资源。您可以对一个项目的所有资源应用任意数量的标签。

标签的常见用途

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

  • 团队或成本中心标签：根据团队或成本中心添加标签，以区分不同团队所拥有的 Filestore 实例（例如 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 调用的时间戳或个别值创建标签。这种方法的问题在于，当值经常变化或键导致目录杂乱时，很难有效地过滤和报告资源。

标签和标记

标签可用作资源可查询的注释，但不能用于设置政策的条件。通过对政策进行精细控制，标记提供了一种有条件地允许或拒绝政策的方法，具体取决于资源是否具有特定的标记。如需了解详情，请参阅标记概览。

为实例添加或更新标签

您可以在创建实例时向 Filestore 实例添加标签。创建实例后，您可以为该实例添加更多标签，还可以更新或删除现有标签。

控制台

  1. 在 Google Cloud 控制台中，前往“Filestore 实例”页面。

    转到“Filestore 实例”页面

  2. 选中要修改其标签的每个实例旁边的复选框。

  3. 点击显示信息面板。

  4. 根据需要添加和更新标签。

    操作 说明
    添加标签 点击添加标签，然后输入标签的键和值。
    更新标签 更新值字段。您无法更新现有标签的键字段。
    删除标签 点击标签旁边的删除项目 。

  5. 完成更新后，点击保存以保存更改。

gcloud

您可以通过运行 instances update 命令。 要添加新标签或更改现有标签的值，请使用 --update-labels 标志。如需删除一个或多个标签，请使用 --remove-labels 标志。--clear-labels 标志用于移除实例的所有标签。

gcloud filestore instances update instance-id \
    --project=project-id \
    --zone=zone \
    --update-labels key=value,[key=value,…] \
    --remove-labels key,[key,…] \
    --clear-labels

其中：

  • instance-id 是您要修改的实例的实例 ID。

  • project-id 是执行上述操作的 Google Cloud 项目的 ID 包含 Filestore 实例。如果 Filestore 实例位于 gcloud 默认项目中，则可以跳过此标志。您可以通过运行以下命令来设置默认项目：

     gcloud config set project project-id

  • zone 是 Filestore 实例所在的区域。运行 gcloud filestore zones list 命令以获取受支持地区的列表。您可以跳过此标志 如果 Filestore 实例使用的是 gcloud 默认值 可用区。您可以通过运行以下命令来设置默认区域：

     gcloud config set filestore/zone zone

  • key 是新标签，或要更改或移除的现有标签。

  • value 是标签的值。

示例

以下示例通过添加 status 标签、更新 dept 标签的值以及移除 admin 标签来更新 nfs-server 实例。

gcloud filestore instances update nfs-server \
    --project=myproject \
    --zone=us-central1-c \
    --update-labels status=active \
    --update-labels dept=accounting \
    --remove-labels admin

目前支持标签的服务

目前，以下 Google Cloud 服务支持标签功能：

  • AI Platform
  • App Engine（柔性环境和标准环境）
  • Artifact Registry
  • BigQuery
  • Certificate Authority Service
  • Cloud Composer
  • Bigtable
  • Cloud Deployment Manager
  • Cloud Run 函数
  • Cloud Healthcare API
  • Cloud Key Management Service
  • Cloud Run
  • Spanner
  • Cloud SQL
  • Cloud Storage
  • Compute Engine
  • Dataflow
  • Dataproc
  • Filestore
  • Google Kubernetes Engine
  • 网络
  • Pub/Sub
  • Resource Manager（仅限项目）

后续步骤

了解如何编辑 Filestore 实例的其他属性。