管理标签

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

什么是标签?

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

标签的常见用途

我们不建议创建大量唯一标签,例如每个 API 调用的时间戳或单个值。以下是标签的一些常见用例:

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

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

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

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

标签要求

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

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

为实例添加或更新标签

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

控制台

  1. 在 Cloud Console 中,转到“Filestore 实例”页面。

    转到“Filestore 实例”页面

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

  3. 点击右上角的显示信息面板以将其打开。

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

    操作 说明
    添加标签 点击添加标签,然后输入标签的键和值。
    更新标签 更新字段。您无法更新现有标签的字段。
    删除标签 点击标签旁边的删除项目
  5. 完成更新后,点击保存以保存更改。

gcloud

您可以通过运行 instances update 命令来修改 Filestore 实例的标签。要添加新标签或更改现有标签的值,请使用 --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 是包含 Filestore 实例的 Cloud 项目的项目 ID。如果 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

后续步骤

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