リソースのタグを管理する

コンソール

リソースの種類によっては、正確な手順が若干異なる場合があります。たとえば、次の手順で VM にタグを付加します。

1. Google Cloud コンソールで [VM インスタンス] ページに移動します。

   [VM インスタンス] に移動

2. プロジェクトを選択し、[続行] をクリックします。

3. [名前] 列で、タグを追加する 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: ターゲット リソースのリージョン（例: us-central1）
• TAGVALUE_ID: タグ値の数値 ID
• PROJECT_NUMBER: プロジェクトの数値 ID
• ZONE: ゾーン名（例: us-central1-a）
• VM_ID: VM インスタンスの ID

API

リソースにタグを付加するには、まず、タグ値の永続 ID または名前空間付きの名前と、リソースの永続 ID を含むタグ バインディングの JSON 表現を作成する必要があります。タグ バインディングの形式の詳細については、TagBinding リファレンスをご覧ください。

VM インスタンスなどのゾーンリソースにタグを付加するには、リソースが配置されているリージョン エンドポイントで tagBindings.create メソッドを使用します。例:

POST https://LOCATION-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: ターゲット リソースが属するロケーション
• PROJECT_NUMBER: プロジェクトの数値 ID
• ZONE: ゾーン名（例: us-central1-a）
• VM_ID: VM の数値 ID
• TAGVALUE_ID: は、付加されているタグ値の永続 ID です。例: 4567890123。
• TAGVALUE_NAMESPACED_NAME は、付加されているタグ値の名前空間付きの名前で、形式は parentNamespace/tagKeyShortName/tagValueShortName です。

コンソール

リソースの種類によっては、正確な手順が若干異なる場合があります。 VM の場合、次の手順を実施します。

1. Google Cloud コンソールで [VM インスタンス] ページに移動します。

   [VM インスタンス] に移動

2. プロジェクトを選択し、[続行] をクリックします。

3. [インスタンスを作成] をクリックします。

4. [タグとラベルを管理] をクリックします。

5. [タグを追加] をクリックします。

6. サイドパネルの指示に沿って、インスタンスに追加するタグを選択します。

7. [保存] をクリックします。

8. VM インスタンスの作成と起動の他の手順を完了して、インスタンスの作成を完了します。

gcloud

リソースの作成時にタグをリソースに付加するには、それぞれの create コマンドで --resource-manager-tags フラグを追加します。たとえば、VM にタグを付加するには、次のコマンドを使用します。

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

次のように置き換えます。

• INSTANCE_NAME: インスタンスの名前
• TAGKEY_ID: タグキー番号の数値 ID
• TAGVALUE_ID: 付加されているタグ値の永続的な数値 ID。例: 4567890123。

複数のタグを指定する場合は、タグをカンマで区切ります（例: TAGKEY1=TAGVALUE1,TAGKEY2=TAGVALUE2）。

API

次の URL に 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: インスタンスの名前
• TAGKEY_ID: タグキー番号の数値 ID
• TAGVALUE_ID: 付加されているタグ値の永続的な数値 ID。例: 4567890123。

コンソール

リソースの種類によっては、正確な手順が若干異なる場合があります。たとえば、次の手順で VM からタグを取り外します。

1. Google Cloud コンソールで [VM インスタンス] ページに移動します。

   [VM インスタンス] に移動

2. プロジェクトを選択し、[続行] をクリックします。

3. [名前] 列で、タグを追加する 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）
• TAGVALUE_ID: タグキーの数値 ID
• PROJECT_NUMBER: プロジェクトの数値 ID
• ZONE: ゾーン名（例: us-central1-a）
• VM_ID: VM インスタンスの ID

既存のタグ バインディングを別のタグ バインディングに更新または置換するには、古いタグ バインディングを取り外して新しいタグ バインディングを付加します。

API

VM などのリソースに付加されたタグ バインディングを削除するには、リソースが配置されているリージョン エンドポイントで tagBindings.delete メソッドを使用します。

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

ここで

• TAGBINDINGS_NAME は TagBinding の永続 ID です。例: tagBindings/%2F%2Fcloudresourcemanager.googleapis.com%2Fprojects%2F1234567890/tagValues/567890123456。

• LOCATION は、リソースのリージョン エンドポイント（us-central1 など）です。

コンソール

リソースの種類によっては、正確な手順が若干異なる場合があります。たとえば、VM のタグを表示する手順は、以下のとおりです。

1. Google Cloud コンソールで [VM インスタンス] ページに移動します。

   [VM インスタンス] に移動

2. プロジェクトを選択し、[続行] をクリックします。

3. [名前] 列で、タグを表示する VM の名前をクリックします。

4. [VM インスタンスの詳細] ページの [タグ] セクションで、目的のタグを探します。

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）
• PROJECT_NUMBER: プロジェクトの数値 ID
• ZONE: ゾーン名（例: us-central1-a）
• VM_ID: VM インスタンスの ID

--effective フラグを tags bindings list コマンドに追加すると、このリソースが継承したすべてのタグのリストも返されます。次のようなレスポンスが返されます。

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

リソースで評価されるすべてのタグが直接付加されている場合は、inherited フィールドが false となり省略されます。

API

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