建立及管理標籤

本頁提供關於標籤的內容摘要,並說明如何使用 Resource Manager API 和 Google Cloud Platform 主控台建立和管理標籤。

什麼是標籤?

標籤是鍵/值組合,協助您組織 Google Cloud Platform 執行個體。您可以為每一個資源加上標籤,並根據標籤來篩選資源。標籤的相關資訊會轉送至帳單系統,所以您可以按標籤查看帳單費用明細

標籤的常見用法

以下是標籤的一些常見用途:

  • 團隊或成本中心標籤:依據團隊或成本中心來新增標籤,以區別不同團隊所擁有的執行個體 (例如,team:researchteam:analytics)。這類的標籤可用於成本會計或預算編列作業。

  • 元件標籤:例如 component:rediscomponent:frontendcomponent:ingestcomponent:dashboard

  • 環境或暫存標籤:例如 environment:productionenvironment:test

  • 狀態標籤:例如,state:activestate:readytodeletestate:archive

  • 虛擬機器標籤:可附加至虛擬機器的標籤。您過去定義的虛擬機器標籤會顯示為沒有值的標籤。

標籤需求

套用於資源的標籤必須符合下列需求條件:

  • 每個資源可以有多個標籤,上限為 64 個。
  • 每個標籤必須是鍵/值組合。
  • 鍵的長度下限為 1 個字元,上限為 63 個字元,不能空白。值可以空白,長度上限為 63 個字元。
  • 鍵和值只能使用小寫字母、數字字元、底線和連字號。所有字元都必須使用 UTF-8 編碼,且容許使用國際字元。
  • 標籤中,鍵的部分不得重複。但可以多個資源使用相同的鍵。
  • 鍵的開頭必須是小寫字母或國際字元。

對於特定的報告服務和專案,一小時期間內保留的不同鍵/值組合數量為 1,000 組。舉例來說,Compute Engine 服務會針對虛擬機器 (VM) 執行個體回報指標。如果您部署的專案包含 2,000 個 VM,且每個 VM 的標籤都不重複,系統只會針對一小時期間內存在的前 1,000 個標籤保留其服務回報指標。

使用 Resource Manager API 建立和管理標籤

若要建立新專案並為專案加上標籤,請在建立專案時設定 label 欄位。

REST

要求:

POST https://cloudresourcemanager.googleapis.com/v1beta1/projects

{
 "labels": {
  "color": "red"
 },
 "name": "myproject",
 "projectId": "our-project-123"
}
回應:

{
 "projectNumber": "333197460082",
 "projectId": "our-project-123",
 "lifecycleState": "ACTIVE",
 "name": "myproject",
 "labels": {
  "color": "red"
 },
 "createTime": "2016-01-12T22:18:28.633Z",
}

Python

...

  project = crm.projects().create(
    body={
        'project_id': flags.projectId,
        'name': 'myproject',
        labels.color: "red"
}).execute()

...


如要為現有專案加上標籤:

  • 使用 get() 方法取得專案。
  • 修改 label 欄位。
  • 使用 update() 方法更新專案。

關於更新專案標籤的詳細說明,請參閱更新專案

關於如何使用標籤篩選專案的詳細資料,請參閱列出專案

使用 GCP 主控台建立和管理標籤

如要為單一專案加上標籤:

  1. 在 GCP 主控台開啟「Labels」(標籤) 頁面。
    開啟「Labels」(標籤) 頁面
  2. 從「Select a project」(選取專案) 下拉式選單中選取專案。
  3. 如要新增標籤項目,請按一下 [+ Add label] (+ 新增標籤),然後為要新增的每個標籤輸入標籤鍵和值。
  4. 新增完標籤後,請按一下 [Save] (儲存)。

如要同時為多個專案加上標籤:

  1. 開啟 GCP 主控台的「Manage resources」(管理資源) 頁面:
    開啟「Manage resources」(管理資源) 頁面
  2. 「Manage resources」(管理資源) 頁面中,選取要加上標籤的機構及專案。
  3. 在右側面板的「Labels」(標籤) 分頁中按一下 [+ Add label] (+ 新增標籤),並為要新增的每個標籤輸入標籤鍵和值。
  4. 新增完標籤後,請按一下 [Save] (儲存)。

新增完標籤後,您可以在專案列表上方的篩選器方塊中輸入標籤鍵或值,以篩選專案。篩選器方塊會建議標籤鍵或值,方便您預覽結果。

目前支援標籤功能的服務

目前支援標籤功能的 GCP 服務如下:

  • BigQuery
  • Cloud BigTable
  • Cloud Dataflow
  • Cloud Dataproc
  • Cloud Deployment Manager
  • Cloud Functions
  • Cloud Key Management Service
  • Cloud Pub/Sub
  • Cloud Spanner
  • Cloud SQL
  • Cloud Storage
  • Compute Engine
  • Google Kubernetes Engine
  • 網路
  • Resource Manager
本頁內容對您是否有任何幫助?請提供意見:

傳送您對下列選項的寶貴意見...

這個網頁
Resource Manager 說明文件