使用標籤整理執行個體及查看費用

本頁說明如何使用 Google Cloud 標籤整理 Spanner 執行個體，並查看詳細的費用明細。

Google Cloud 標籤是可指派給個別 Google Cloud 資源 (例如 Spanner 執行個體) 的鍵/值組合。

有助於整理這些資源，並依所需精細程度查看費用。標籤相關資訊會轉送到結帳系統，方便依照標籤詳細分析帳單費用。如要進一步瞭解標籤，請參閱「標籤總覽」。

標籤的常見用途

標籤的常見用途包括：

• 團隊或成本中心標籤：區別不同團隊 (例如 team:research 和 team:analytics) 擁有的資源，以利成本會計或預算編列作業。
• 環境標籤：指定開發、測試或實際工作環境 (例如 env:dev、env:test 和 env:prod)。
• 元件標籤：依應用程式元件或工作負載類型分類資源 (例如 component:frontend 和 component:backend)。
• 精細的執行個體層級追蹤：為 Spanner 執行個體加上專屬 ID 或特定 ID (例如 instance_id:my-instance-1)，即可在帳單報表或 BigQuery 查詢中，直接細分每個執行個體的費用。

需求和限制

套用至 Spanner 執行個體的標籤必須符合下列規定：

• 每個執行個體最多可以有 64 個標籤。
• 鍵和值不得超過 63 個字元。
• 鍵和值只能使用小寫字母、數字字元、底線 (_) 和連字號 (-)。
• 鍵的開頭必須是小寫字母或國際字元。鍵不得為空白。
• 標籤中的鍵部分不得重複，

在 Spanner 執行個體上新增及管理標籤

您可以在建立 Spanner 執行個體時新增標籤，也可以更新現有執行個體的標籤。

所需權限

如要查看及管理 Spanner 執行個體的標籤，您必須具備下列 IAM 權限：

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

這些權限包含在 roles/spanner.admin 角色中。

新增、更新或移除標籤

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

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

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

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)。