標記總覽

標記是可附加至Google Cloud 資源的鍵/值組合,用於為資源加上註解,並依條件強制執行政策。這項條件式強制執行功能可讓您精細控管 Google Cloud 資源階層中的資源。

Google Cloud 資源階層會以樹狀結構整理資源,方便您大規模管理資源。不過,這個階層只會模擬少數業務維度,包括組織結構、區域、工作負載類型和成本中心。標記可讓您靈活地在階層中將多個業務維度疊加在一起。

標記和標籤

標籤是另一種建立資源註解的方式。下表列出標記和標籤的部分差異:

標記 標籤
資源結構 標記鍵、標記值和標記繫結都是獨立資源 本身不是資源,而是資源的中繼資料
定義 在組織或專案層級定義 由各項資源定義
存取控管 管理及附加標記時,必須具備 Identity and Access Management (IAM) 角色 附加標籤需要 IAM 角色,具體取決於服務資源
附件必備條件 必須先定義標記鍵和標記值,才能將標記附加至資源 不需任何先備知識
是否沿用設定 標記繫結會由 Google Cloud 階層中資源的子項繼承 不會由資源的子項繼承
刪除規定 除非標記沒有任何繫結,否則無法刪除 隨時可以從資源中移除
命名需求 標記值和標記鍵規定 標籤需求
鍵/值名稱長度 最多 256 個半形字元 最多 63 個半形字元
允許和拒絕政策支援 允許政策條件和拒絕政策條件可參照標記 不支援允許和拒絕政策
組織政策支援 組織政策條件式限制可參照部分資源的標記 不支援組織政策
Cloud Billing 整合 執行交易退單、稽核和其他成本分配分析,將 Cloud Billing 費用資料匯出至 BigQuery 在 Cloud Billing 中依標籤篩選資源,將 Cloud Billing 資料匯出至 BigQuery

如要進一步瞭解標籤,請參閱「建立及管理標籤」。

語意標記

語意標記是一種鍵/值組合,可為資源提供有意義的中繼資料,並採用 OpenTelemetry (OTel) 慣例支援的強大標準化語意。

您可以將語意標記與 App Hub 資源搭配使用。在 App Hub 中設定服務和工作負載的屬性時,App Hub 會自動將這些屬性複製為直接基礎資源的唯讀系統語意標記。

系統語意標記為唯讀,您無法直接使用 Tags API 或 Google Cloud 控制台編輯或移除這些系統標記。標記管理作業會在 App Hub 內進行。

App Hub 複製的語意標記

如果您使用 App Hub,系統會自動將服務或工作負載上設定的「Environment」(環境) 和「Criticality」(重要性) 屬性,複製為專屬命名空間 google:AppHub 下的唯讀系統語意標記。

支援的系統標記包括:

  • google:AppHub/environment:衍生自 App Hub 的值,例如 PRODUCTION 或 STAGING。
  • google:AppHub/criticality:衍生自 App Hub 的值,例如 MISSION_CRITICAL 或 HIGH。

將 App Hub 情境顯示為系統標記,可確保 Google Cloud 控制台等下游服務使用權威中繼資料,強制執行管理和安全性政策,避免手動設定帶來的風險。

如要進一步瞭解如何管理語意標記,請參閱「查看及管理語意標記」。

語意目錄

語意目錄會列出可用的語意,以及這些語意與 OpenTelemetry (OTel) 支援屬性的對應關係。您可以在 Google Cloud 控制台瀏覽這個目錄,或使用 API 查看詳細資料。

如要進一步瞭解如何存取目錄,請參閱「查看語意目錄」。

語意鍵 OTel 屬性鍵 語意值 OTel 屬性值
ENVIRONMENT deployment.environment.name PRODUCTION production
STAGING staging
TEST test
DEVELOPMENT development
CRITICALITY service.criticality MISSION_CRITICAL critical
HIGH high
MEDIUM medium
LOW low

語意標記的限制

語意標記有下列限制:

  • 自訂繫結:您無法透過 Tags API,直接將 ENVIRONMENT 或 CRITICALITY 語意標記繫結至資源或 Resource Manager 節點 (專案、資料夾或組織)。
  • 使用者定義的語意:不支援將現有標記升級為語意標記。
  • 僅限直接資源:同步處理作業只會套用至在 App Hub 註冊的直接資源。不會傳播至服務或工作負載中的巢狀或間接資源 (例如 MIG 中的個別 VM)。

建立標記

標記的結構為鍵/值組合。您可以在組織或專案資源下建立標記鍵資源,而標記值則是附加至鍵的資源,例如標記鍵 environment,其值為 production 和 development。

標記管理

管理員可以限制哪些使用者能建立、更新、刪除標記,以及將標記附加至資源,藉此控管標記的使用。他們可以選取個別標記進行編輯,例如新增或移除值,以及更新說明。這樣一來,您就能精細控管代碼。

標記可選擇是否要加上說明,在擷取標記相關資訊時顯示。說明可協助將標記附加至資源的使用者瞭解標記的用途。

在父項專案或組織中,每個標記鍵都不得重複。這可確保每個標記值繫結至資源時,都會與其標記鍵建立不重複的配對。

政策和標記

您可以搭配使用標記和 IAM 條件,以便:

建立標記值後,即可將標記值繫結至資源。接著,您可以建立具有條件的 IAM 政策,根據標記索引鍵是否已繫結至資源,來識別資源。如要瞭解如何使用標記和 IAM 條件,請參閱「標記和條件式存取權」。

代碼異動的影響

如果您使用標記有條件地授予或拒絕存取權,或限定組織政策範圍,則從資源繫結或解除繫結標記可能會變更這些政策的影響。

舉例來說,假設您有一組開發人員需要管理 Compute Engine 執行個體,但只能管理用於開發的執行個體:

  1. 標記定義:您有一個標記鍵 123456789012/env,其值為 dev 和 prod。
  2. 條件式存取權:您將 Compute 執行個體管理員角色 (roles/compute.instanceAdmin) 授予開發人員群組。您在角色繫結中新增條件,規定只有在資源具有 env: dev 標記時,才能授予存取權。
  3. 異動影響:
    • 繫結標記:將標記 env: dev 附加至執行個體。條件式角色繫結現在會授予開發人員管理執行個體的權限。
    • 解除繫結標記:之後,同一個執行個體會升級至正式環境。您解除繫結 env: dev 標記,並繫結 env: prod 標記。條件式角色繫結不再授予開發人員管理這個執行個體的權限。

一般來說,代碼變更會在 2 分鐘內生效。不過,變更最多可能需要 7 分鐘才會在系統中全面生效。這項傳播延遲會影響授予或撤銷存取權的速度,或是在標記繫結或解除繫結後,組織政策生效的速度。

使用組織政策強制執行必要標記

您可以使用自訂組織政策,強制對資源套用必要標記。強制執行必要標記時,您只能建立符合組織標記政策的資源,也就是資源會與政策中指定的必要標記鍵標記值繫結。詳情請參閱「設定自訂限制來強制執行標記」。

下列資源類型支援強制執行必要標記:

  • Resource Manager 專案和資料夾
  • Filestore 執行個體
  • AlloyDB for PostgreSQL 叢集和備份資源
  • Workflows 工作流程
  • Compute Engine 資源:
    • 執行個體
    • 磁碟
    • 外部 VPN 閘道
    • VPN 閘道
    • 目標 VPN 閘道
    • VPN 通道
    • 互連網路
    • 互連網路連結
    • 後端服務
    • 區域性後端服務
    • 後端 bucket
  • 虛擬私有雲資源:
    • 網路
    • 子網路
    • 防火牆規則
    • Routes

標記繼承

將標記值附加至資源時,根據預設,資源的所有子系都會沿用相同的標記值。您可以覆寫子系資源上繼承的標記值。如要覆寫沿用的標記值,請將不同的標記值繫結至子系資源。不同的標記值必須使用與繼承標記值相同的標記鍵。

舉例來說,假設您將 environment: development 標記套用至某個資料夾,而該資料夾有兩個子資料夾,分別名為 team-a 和 team-b。您也可以將不同的標記 environment: test 套用至 team-b 資料夾。因此,team-a 資料夾中的專案和其他資源會繼承 environment: development 標記,而 team-b 資料夾中的專案和其他資源會繼承 environment: test 標記:

含有標記的資源階層

含有標記的資源階層

如果從 team-b 資料夾中移除 environment: test 標記,該資料夾及其資源會繼承 environment: development 標記。

附加至資源並由資源繼承的所有標記,統稱為「有效標記」。資源的有效標記,是直接附加至資源的標記,以及附加至資源在階層中所有祖系的標記組合。

搭配 IAM 條件使用標記時,建議您為 IAM 條件使用的每個標記鍵建立安全的預設標記值。將安全預設標記值繫結至組織,即可套用該標記值,讓組織內的所有資源繼承該值。如要變更標記值,請明確覆寫相關資源的繼承繫結。

舉例來說,假設您有一個 IAM 條件,取決於 enforcement 標記鍵的 on 標記值,而該標記鍵也有 off 標記值。將標記值 enforcement: off 繫結至組織,建立安全的預設值,讓組織內的所有資源繼承。僅將標記值 enforcement: on 繫結至組織內所選資源。

接著,您可以編寫處理 enforcement 標記鍵的政策,並設定條件,在資源為 enforcement: on 或 enforcement: off 時影響資源,並在資源為 enforcement: default 時提供安全案例。如果從資源中移除 enforcement 標記鍵,資源就會從父項資源繼承 enforcement 的標記值。如果沒有任何父項資源具有 enforcement 標記鍵,資源會從組織資源繼承 enforcement: default。

使用安全的預設標記可以提供協助,但為了避免非預期的行為,建議您先檢查標記和政策,並設定條件,再移動資源或移除標記。

刪除標記鍵和值

您必須先刪除所有使用標記值的資源繫結,才能刪除標記值。

防止標記值遭到刪除

您可以將標記保留附加至標記值,為標記值建立額外的保護層。標記保留與標記繫結一樣,可防止使用者刪除標記值。

某些資源會自動對附加至資源的每個標記值建立標記保留。必須先移除這個標記保留項目,才能刪除標記值。

後續步驟