建立及管理標記

您可以將標記附加至下列 Google Cloud 負載平衡資源:

  • 後端值區
  • 後端服務
  • 轉送規則
  • 健康狀態檢查
  • 執行個體群組 (區域)
  • 網路端點群組
  • SSL 政策
  • SSL 憑證
  • 目標執行個體
  • 目標集區
  • 目標 gRPC Proxy
  • 目標 HTTP(S) Proxy
  • 目標 SSL Proxy
  • 目標 TCP Proxy
  • 網址對應

關於代碼

標記是可附加至Google Cloud內資源的鍵/值組合。您可以根據資源是否具備特定標記,有條件地允許或拒絕政策。舉例來說,您可以根據資源是否具備特定標記,有條件地授予 Identity and Access Management (IAM) 角色。如要進一步瞭解標記,請參閱「標記總覽」。

如要將標記附加至資源,請建立標記繫結資源,將值連結至 Google Cloud 資源。

如要將負載平衡資源分組,以利自動化和計費,請使用標籤。標記和標籤各自獨立運作,您可以同時將兩者套用至資源。

所需權限

如要取得管理標記所需的權限,請管理員授予下列 IAM 角色:

  • 標記檢視者 (roles/resourcemanager.tagViewer) 標記附加的資源
  • 在機構層級查看及管理標記: 機構檢視者 (roles/resourcemanager.organizationViewer) 機構
  • 建立、更新及刪除代碼定義: 您要建立、更新或刪除代碼的資源必須具備代碼管理員 (roles/resourcemanager.tagAdmin) 權限
  • 在資源中附加及移除標記: 標記使用者 (roles/resourcemanager.tagUser) 在標記值和要附加/移除標記值的資源上

如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和機構的存取權」。

您或許還可透過自訂角色或其他預先定義的角色取得必要權限。

如要將標記附加至負載平衡資源,您需要 Compute 網路管理員角色 (roles/compute.networkAdmin) 和 Compute 安全性管理員角色 (roles/compute.securityAdmin)。

建立標記鍵和值

您必須先建立標記並設定其值,才能附加標記。 如要建立標記鍵和標記值,請參閱「建立標記」和「新增標記值」。

在建立資源時新增標記

您可以在建立後端服務或後端 bucket 時新增標記。在建立資源時新增標記,可立即提供資源的重要中繼資料,並協助您妥善整理資源、追蹤費用,以及自動套用政策。

gcloud

如要在建立資源時將標記附加至資源,請將 --resource-manager-tags 旗標搭配相應的 create 指令使用。舉例來說,如要將標記附加至後端 bucket,請使用下列指令:

gcloud compute backend-buckets create BACKEND_BUCKET_NAME \
    --gcs-bucket-name=BUCKET_NAME \
    --resource-manager-tags=tagKeys/TAGKEY_ID=tagValues/TAGVALUE_ID

更改下列內容:

  • BACKEND_BUCKET_NAME:後端 bucket 的名稱
  • BUCKET_NAME:儲存空間 bucket 的名稱
  • TAGKEY_ID:標記鍵號碼數值 ID
  • TAGVALUE_ID:附加的代碼值永久數字 ID,例如:4567890123

如要指定多個標記,請以半形逗號分隔,例如 TAGKEY1=TAGVALUE1,TAGKEY2=TAGVALUE2

為現有資源新增標記

如要為現有的負載平衡資源新增標記,請按照下列步驟操作:

gcloud

如要將標記附加至負載平衡資源,請使用 gcloud resource-manager tags bindings create 指令建立標記繫結資源:

      gcloud resource-manager tags bindings create \
          --tag-value=TAGVALUE_NAME \
          --parent=RESOURCE_ID \
          --location=LOCATION
      

更改下列內容:

  • TAGVALUE_NAME:附加標記值的永久 ID 或命名空間名稱,例如 tagValues/567890123456
  • RESOURCE_ID:資源的完整 ID,包括用於識別資源類型的 API 網域名稱 (//compute.googleapis.com/)。

    例如:

    • 全域資源的資源 ID,例如 projects/7890123456 中的目標 HTTP Proxy,如下所示: //compute.googleapis.com/projects/7890123456/global/targetHttpProxies/{resource-id}
    • 區域資源的資源 ID,例如 projects/7890123456 中的區域後端服務,如下所示: //compute.googleapis.com/projects/7890123456/regions/REGION/backendServices/{resource-id}
    • 區域資源的資源 ID,例如 projects/7890123456 中的網路端點群組,如下所示: //compute.googleapis.com/projects/7890123456/zones/ZONE/networkEndpointGroups/{resource-id}
  • LOCATION:資源位置。如要將標記附加至全域資源 (例如資料夾或專案),請省略這個旗標。如要將標記附加至區域或地區資源,請務必指定位置,例如 us-central1 (區域) 或 us-central1-a (地區)。

列出附加至資源的標記

您可以查看直接附加至負載平衡資源或由該資源沿用的代碼繫結清單。

gcloud

如要取得附加至資源的標記繫結清單,請使用 gcloud resource-manager tags bindings list 指令:

      gcloud resource-manager tags bindings list \
          --parent=RESOURCE_ID \
          --location=LOCATION
      

更改下列內容:

  • RESOURCE_ID:資源的完整 ID,包括用於識別資源類型的 API 網域名稱 (//compute.googleapis.com/)。

    例如:

    • 全域資源的資源 ID,例如 projects/7890123456 中的目標 HTTP Proxy,如下所示: //compute.googleapis.com/projects/7890123456/global/targetHttpProxies/{resource-id}
    • 區域資源的資源 ID,例如 projects/7890123456 中的區域後端服務,如下所示: //compute.googleapis.com/projects/7890123456/regions/REGION/backendServices/{resource-id}
    • 區域資源的資源 ID,例如 projects/7890123456 中的網路端點群組,如下所示: //compute.googleapis.com/projects/7890123456/zones/ZONE/networkEndpointGroups/{resource-id}
  • LOCATION:資源位置。如果您要查看附加至資料夾或專案等全域資源的標記,請省略這個標記。如果查看附加至區域或地區資源的標記,則必須指定位置,例如 us-central1 (區域) 或 us-central1-a (地區)。

您應該會得到類似以下的回覆:

name: tagBindings/%2F%2Fcloudresourcemanager.googleapis.com%2Fprojects%2F7890123456/tagValues/567890123456
          tagValue: tagValues/567890123456
          resource: 
//compute.googleapis.com/projects/7890123456/regions/REGION/targetHttpProxies/{resource-id}

      

從資源卸離標記

您可以將直接附加至負載平衡資源的標記分離。如要覆寫繼承的標記,請附加具有相同鍵和不同值的標記,但無法卸離。

gcloud

如要刪除標記繫結,請使用 gcloud resource-manager tags bindings delete 指令:

      gcloud resource-manager tags bindings delete \
          --tag-value=TAGVALUE_NAME \
          --parent=RESOURCE_ID \
          --location=LOCATION
      

更改下列內容:

  • TAGVALUE_NAME:附加標記值的永久 ID 或命名空間名稱,例如 tagValues/567890123456
  • RESOURCE_ID:資源的完整 ID,包括用於識別資源類型的 API 網域名稱 (//compute.googleapis.com/)。

    例如:

    • 全域資源的資源 ID,例如 projects/7890123456 中的目標 HTTP Proxy,如下所示: //compute.googleapis.com/projects/7890123456/global/targetHttpProxies/{resource-id}
    • 區域資源的資源 ID,例如 projects/7890123456 中的區域後端服務,如下所示: //compute.googleapis.com/projects/7890123456/regions/REGION/backendServices/{resource-id}
    • 區域資源的資源 ID,例如 projects/7890123456 中的網路端點群組,如下所示: //compute.googleapis.com/projects/7890123456/zones/ZONE/networkEndpointGroups/{resource-id}
  • LOCATION:資源位置。如要將標記附加至全域資源 (例如資料夾或專案),請省略這個旗標。如要將標記附加至區域或地區資源,請務必指定位置,例如 us-central1 (區域) 或 us-central1-a (地區)。

刪除標籤鍵和值

移除標籤鍵或值定義時,請務必將標籤從負載平衡資源中分離。您必須先刪除現有代碼附件 (稱為代碼繫結),才能刪除代碼定義本身。如要刪除標記鍵和標記值,請參閱刪除標記

身分與存取權管理條件和標記

您可以使用標記和 IAM 條件,有條件地將角色繫結授予階層中的使用者。如果已套用具有條件角色繫結的 IAM 政策,變更或刪除附加至資源的標記,可能會移除使用者對該資源的存取權。詳情請參閱「身分與存取權管理條件和標記」。

後續步驟