使用标签整理实例并查看费用

本页面介绍了如何使用 Google Cloud 标签来整理 Spanner 实例并查看精细的费用明细。

Google Cloud 标签是一种键值对，您可以将其分配给各个 Google Cloud 资源，例如 Spanner 实例。

标签可帮助您整理这些资源，并按照所需的粒度查看费用。标签的相关信息会转发到结算系统，以便您按标签细分结算费用。如需详细了解标签，请参阅标签概览。

标签的常见应用场景

标签的一些常见应用场景包括：

  • 团队或成本中心标签：区分不同团队（例如 team:research 和 team:analytics）所拥有的资源，以便进行成本核算或预算。
  • 环境标签：指定开发、测试或生产环境（例如 env:dev、env:test 和 env:prod）。
  • 组件标签：按应用组件或工作负载类型对资源进行分类（例如 component:frontend 和 component:backend）。
  • 精细的实例级跟踪：为 Spanner 实例添加其自己的 ID 或特定标识符（例如 instance_id:my-instance-1），以便在结算报告或 BigQuery 查询中直接按实例细分费用。

要求和限制

应用于 Spanner 实例的标签必须满足以下要求：

  • 每个实例最多可以有 64 个标签。
  • 键和值不得超过 63 个字符。
  • 键和值只能包含小写字母、数字字符、下划线 (_) 和短划线 (-)。
  • 键必须以小写字母或国际字符开头。键不能为空。
  • 标签的键部分在单个实例内必须是唯一的。

在 Spanner 实例上添加和管理标签

您可以在创建 Spanner 实例时添加标签，也可以更新现有实例上的标签。

所需权限

如需查看和管理 Spanner 实例上的标签，您需要以下 IAM 权限：

  • spanner.instances.get
  • spanner.instances.update

这些权限包含在 roles/spanner.admin 角色中。

添加、更新或移除标签

控制台

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

    前往 Spanner 实例

  2. 选中要添加标签的实例旁边的复选框。系统会显示信息面板。

  3. 在信息面板中，选择标签。

  4. 为实例添加、更新或删除标签，然后点击保存。

gcloud

如需创建带有标签的 Spanner 实例，请运行带有 --labels 标志的 gcloud spanner instances create 命令：

gcloud spanner instances create INSTANCE_ID \
    --config=INSTANCE_CONFIG \
    --description=INSTANCE_NAME \
    --nodes=NODE_COUNT \
    --labels=KEY=VALUE,KEY=VALUE

如需为现有实例添加或更新标签，请运行带有 --update-labels 标志的 gcloud spanner instances update 命令：

gcloud spanner instances update INSTANCE_ID \
    --update-labels=KEY=VALUE,KEY=VALUE

如需从现有实例中移除特定标签，请使用 --remove-labels 标志：

gcloud spanner instances update INSTANCE_ID \
    --remove-labels=KEY1,KEY2

如需清除现有实例的所有标签，请使用 --clear-labels 标志：

gcloud spanner instances update INSTANCE_ID --clear-labels

在 Cloud Billing 中按标签分析 Spanner 费用

为 Spanner 实例应用标签后，您可以使用这些标签来分析费用。标签会转发到您的费用数据，以便您过滤和分组费用。

在结算报告中查看按标签分组的费用

您可以直接在 Google Cloud 控制台中查看按标签键分组的 Spanner 费用：

  1. 在 Google Cloud 控制台中，前往结算部分。
  2. 选择您的结算账号，然后点击导航窗格中的报告。
  3. 在过滤条件面板中：
    1. 在服务下，选择 Spanner 以隔离 Spanner 数据库费用。
    2. 在分组依据下，选择标签键，然后选择要分析的标签键（例如 environment 或 instance_id）。
  4. 图表和费用表会更新，以显示按每个标签值（例如 environment:prod 和 environment:dev，或 instance_id:my-instance-1 和 instance_id:my-instance-2）分组的费用详细明细。