本頁面說明如何使用 Google Cloud 標籤整理 Spanner 執行個體,以及查看精細的費用明細。
Google Cloud 標籤是一種鍵/值組合,可指派給個別 Google Cloud 資源,例如 Spanner 執行個體。
標籤可協助您整理這些資源,並依所需精細程度查看成本。標籤相關資訊會轉送到結帳系統,方便依照標籤詳細分析帳單費用。如要進一步瞭解標籤,請參閱「標籤總覽」。
標籤的常見用途
標籤的常見用途包括:
- 團隊或成本中心標籤:區分不同團隊 (例如
team:research和team:analytics) 擁有的資源,以便進行成本會計或預算編列。 - 環境標籤:指定開發、測試或正式環境 (例如
env:dev、env:test和env:prod)。 - 元件標籤:依應用程式元件或工作負載類型分類資源 (例如
component:frontend和component:backend)。 - 精細的執行個體層級追蹤:使用專屬 ID 或特定 ID (例如
instance_id:my-instance-1) 標記 Spanner 執行個體,直接在帳單報表或 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 控制台的「Billing」(帳單) 專區。
- 選取「Billing Account」(帳單帳戶),然後按一下導覽窗格中的「Reports」(報表)。
- 在「篩選器」面板中:
- 在「Services」(服務) 下方,選取「Spanner」,即可單獨查看 Spanner 資料庫費用。
- 在「Group by」(分組依據) 下方,選取「Label keys」(標籤鍵),然後選擇要分析的標籤鍵 (例如
environment或instance_id)。
- 圖表和費用表會更新,顯示依各標籤值分組的費用詳細明細 (例如
environment:prod和environment:dev,或instance_id:my-instance-1和instance_id:my-instance-2)。