管理資源的標記

主控台

視資源類型而定，實際步驟可能有所不同。舉例來說，下列步驟會將標記附加至 VM：

1. 前往 Trusted Cloud 控制台的「VM instances」(VM 執行個體) 頁面。

   前往 VM 執行個體

2. 選取您的專案並點選 [繼續]。

3. 在「Name」(名稱) 欄中，按一下要新增標記的 VM 名稱。

4. 在「VM 執行個體詳細資料」頁面上，完成下列步驟：

   1. 按一下 [編輯]。
   2. 在「基本資訊」部分中，按一下「管理標記」，然後為執行個體新增所需標記。
   3. 按一下 [儲存]。

gcloud

如要瞭解如何使用這些標記，請參閱 Resource Manager 說明文件中的「將標記附加至資源」。

舉例來說，下列指令會將標記附加至 VM：

gcloud resource-manager tags bindings create \
    --location LOCATION_NAME \
    --tag-value=tagValues/TAGVALUE_ID \
    --parent=//compute.googleapis.com/projects/PROJECT_NUMBER/zones/ZONE/instances/VM_ID

更改下列內容：

• LOCATION_NAME：包含目標資源的區域；在本例中，是 VM 執行個體的區域
• TAGVALUE_ID：標記值的數值 ID
• PROJECT_NUMBER：包含目標資源的專案數字 ID
• ZONE：包含目標資源的可用區；在本範例中，這是指 VM 執行個體的可用區
• VM_ID：VM 執行個體 ID

REST

如要將標記附加至資源，您必須先建立標記繫結的 JSON 表示法，其中包含標記值的永久 ID 或命名空間名稱，以及資源的永久 ID。如要進一步瞭解標記繫結的格式，請參閱tagBindings 參考資料。

如要將標記附加至區域資源 (例如 VM 執行個體)，請使用 tagBindings.create 方法，並搭配資源所在的區域端點。例如：

POST https://LOCATION_NAME-cloudresourcemanager.googleapis.com/v3/tagBindings

要求主體可以是下列其中一個選項：

{
  "parent": "//compute.googleapis.com/projects/PROJECT_NUMBER/zones/ZONE/instances/VM_ID",
  "tagValue": "tagValue/TAGVALUE_ID"
}

{
  "parent": "//compute.googleapis.com/projects/PROJECT_NUMBER/zones/ZONE/instances/VM_ID",
  "tagValueNamespacedName": TAGVALUE_NAMESPACED_NAME
}

更改下列內容：

• LOCATION_NAME：包含目標資源的區域；在本例中，為 VM 執行個體的區域
• PROJECT_NUMBER：包含目標資源的專案數字 ID
• ZONE：包含目標資源的可用區；在本例中，這是 VM 執行個體的可用區
• VM_ID：VM 執行個體 ID
• TAGVALUE_ID：附加的標記值永久 ID，例如：4567890123
• TAGVALUE_NAMESPACED_NAME：附加標記的值的命名空間名稱，格式為： parentNamespace/tagKeyShortName/tagValueShortName

主控台

視資源類型而定，確切步驟可能會有所不同。以下步驟適用於 VM：

1. 前往 Trusted Cloud 控制台的「VM instances」(VM 執行個體) 頁面。

   前往 VM 執行個體

2. 選取您的專案並點選 [繼續]。

3. 按一下「Create instance」(建立執行個體)。「建立執行個體」頁面隨即顯示，並顯示「機器設定」窗格。

4. 在導覽選單中，按一下「進階」。在隨即顯示的「進階」窗格中，執行下列操作：

   1. 展開「管理標記和標籤」expand_more部分。
   2. 按一下「新增標記」add。
   3. 在隨即開啟的「標記」窗格中，按照操作說明將標記新增至執行個體。
   4. 按一下 [儲存]。

5. 指定執行個體的其他設定選項。詳情請參閱「建立執行個體時的設定選項」。

6. 如要建立並啟動 VM，請按一下 [Create] (建立)。

gcloud

如要在建立資源時附加標記，請使用相應的 create 指令新增 --resource-manager-tags 旗標。舉例來說，如要將標記附加至 VM，請使用下列指令：

  gcloud compute instances create INSTANCE_NAME \
      --zone=ZONE \
      --resource-manager-tags=tagKeys/TAGKEY_ID=tagValues/TAGVALUE_ID

更改下列內容：

• INSTANCE_NAME：VM 執行個體的名稱
• ZONE：包含 VM 執行個體的可用區
• TAGKEY_ID：標記鍵編號數值 ID
• TAGVALUE_ID：附加標記值的永久數字 ID，例如：4567890123

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

REST

請對以下網址提出 POST 要求：

POST https://compute.googleapis.com/compute/v1/projects/PROJECT/zones/ZONE/instances

加入下列 JSON 要求內文：

{
  "name": INSTANCE_NAME,
  "params": {
    "resourceManagerTags": {
      "tagKeys/TAGKEY_ID": "tagValues/TAGVALUE_ID",
    },
  }
  // other fields omitted
}

更改下列內容：

• INSTANCE_NAME：VM 執行個體的名稱
• TAGKEY_ID：標記鍵編號數值 ID
• TAGVALUE_ID：附加標記值的永久數字 ID，例如：4567890123

主控台

視資源類型而定，確切步驟可能略有不同。舉例來說，下列步驟會從 VM 中分離標記：

1. 前往 Trusted Cloud 控制台的「VM instances」(VM 執行個體) 頁面。

   前往 VM 執行個體

2. 選取您的專案並點選 [繼續]。

3. 在「Name」(名稱) 欄中，按一下要新增標記的 VM 名稱。

4. 在「VM 執行個體詳細資料」頁面上，完成下列步驟：

   1. 按一下 [編輯]。
   2. 在「基本」部分，按一下「管理標記」，然後移除執行個體所需的標記。
   3. 按一下 [儲存]。

gcloud

以下範例使用 gcloud CLI 從 VM 分離標記：

gcloud resource-manager tags bindings delete \
    --location LOCATION_NAME \
    --tag-value=tagValues/TAGVALUE_ID \
    --parent //compute.googleapis.com/projects/PROJECT_NUMBER/zones/ZONE/instances/VM_ID

更改下列內容：

• LOCATION_NAME：目標資源的可用區，例如 us-central1-a
• TAGVALUE_ID：標記鍵的數值 ID
• PROJECT_NUMBER：包含目標資源的專案數字 ID
• ZONE：可用區名稱，例如 us-central1-a
• VM_ID：VM 執行個體的數值 ID

如要更新或將現有標記繫結替換為其他標記繫結，請先卸離舊的標記繫結，然後附加新的標記繫結。

REST

如要刪除附加至資源 (例如 VM) 的標記繫結，請使用 tagBindings.delete 方法，並搭配資源所在的區域端點。

DELETE https://LOCATION-cloudresourcemanager.googleapis.com/v3/{name=TAGBINDINGS_NAME}

更改下列內容：

• LOCATION：資源的區域端點，例如 us-central1
• TAGBINDINGS_NAME：TagBinding 的永久 ID，例如： tagBindings/%2F%2Fcloudresourcemanager.googleapis.com%2Fprojects%2F1234567890/tagValues/567890123456

主控台

視資源類型而定，確切步驟可能略有不同。舉例來說，下列步驟說明如何查看 VM 的標記：

1. 前往 Trusted Cloud 控制台的「VM instances」(VM 執行個體) 頁面。

   前往 VM 執行個體

2. 選取您的專案並點選 [繼續]。

3. 在「Name」(名稱) 欄中，按一下要查看標記的 VM 名稱。

4. 在「VM instance」(VM 執行個體) 詳細資料頁面中，找出「Tags」(標記) 區段下的標記。

gcloud

如要取得直接附加至資源的標記繫結清單，請使用 gcloud resource-manager tags bindings list 指令。如果您新增 --effective 旗標，系統也會傳回這個資源繼承的標記清單。例如：

gcloud resource-manager tags bindings list \
    --location=LOCATION_NAME \
    --parent //compute.googleapis.com/projects/PROJECT_NUMBER/zones/ZONE/instances/VM_ID

更改下列內容：

• LOCATION_NAME：目標資源的可用區，例如 us-central1-a
• PROJECT_NUMBER：包含目標資源的專案數值 ID
• ZONE：可用區名稱，例如 us-central1-a
• VM_ID：VM 執行個體的數值 ID

如果您在 tags bindings list 指令中加入 --effective 標記，也會傳回這個資源沿用的所有標記清單。

輸出結果會與下列內容相似：

namespacedTagKey: 961309089256/environment
namespacedTagValue: 961309089256/environment/production
tagKey: tagKeys/417628178507
tagValue: tagValues/247197504380
inherited: true

如果資源上評估的所有標記都是直接附加，則 inherited 欄位為 false，且會省略。

REST

如要列出附加至地區資源 (例如 Compute Engine 執行個體) 的標籤繫結，請搭配資源所在地區的端點使用 tagBindings.list 方法。例如：

GET https://LOCATION_NAME-cloudresourcemanager.googleapis.com/v3/tagBindings

{
    "parent": "//compute.googleapis.com/projects/PROJECT_NUMBER/zones/ZONE/instances/VM_ID"
}

更改下列內容：

• LOCATION_NAME：目標資源的區域，例如 us-central1
• PROJECT_NUMBER：包含目標資源的專案數值 ID
• ZONE：可用區名稱，例如 us-central1-a
• VM_ID：VM 執行個體的數值 ID