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

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

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

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

标签的常见用例

标签的一些常见用例包括：

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