本頁說明如何使用 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.getspanner.instances.update
這些權限包含在 roles/spanner.admin 角色中。
新增、更新或移除標籤
控制台
前往 Google Cloud 控制台的「Spanner Instances」(Spanner 執行個體) 頁面。
找出要加上標籤的執行個體,然後選取旁邊的核取方塊。「Info panel」(資訊面板) 隨即顯示。
在「資訊面板」中選取「標籤」。
為執行個體新增、更新或刪除標籤,然後按一下「儲存」。
gcloud
如要建立含標籤的 Spanner 執行個體,請執行 gcloud spanner instances create 指令搭配 --labels 旗標:
gcloud spanner instances create INSTANCE_ID \
--config=INSTANCE_CONFIG \
--description=INSTANCE_NAME \
--nodes=NODE_COUNT \
--labels=KEY=VALUE,KEY=VALUE
如要新增或更新現有執行個體的標籤,請執行 gcloud spanner instances update 指令並搭配 --update-labels 旗標:
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 費用:
- 前往 Google Cloud 控制台的「帳單」部分。
- 選取帳單帳戶,然後按一下導覽窗格中的「報表」。
- 在「篩選器」面板中:
- 在「服務」下方選取「Spanner」,即可查看 Spanner 資料庫的費用。
- 在「Group by」(分組依據) 下方,選取「Label keys」(標籤鍵),然後選擇要分析的標籤鍵 (例如
environment或instance_id)。
- 圖表和費用表會更新,顯示依每個標籤值分組的費用細目 (例如
environment:prod和environment:dev,或instance_id:my-instance-1和instance_id:my-instance-2)。