タグの作成と管理

タグについて

タグは、Google Cloud内のリソースに適用できる Key-Value ペアです。タグを使用すると、リソースに特定のタグが付加されているかどうかに基づいて、条件付きでポリシーの許可や拒否を行うことができます。たとえば、リソースに特定のタグがあるかどうかに基づいて、Identity and Access Management（IAM）のロールを条件付きで付与できます。タグの詳細については、タグの概要をご覧ください。

タグは、タグと リソースを結びつけるタグ バインディング リソースを作成することによって、リソースに適用されます。 Google Cloud

Bigtable インスタンスはグローバル リソースです。 自動化と課金のために Bigtable 内でインスタンスをグループ化する場合は、 ラベルを使用します。 タグとラベルは互いに独立しているので、リソースにタグとラベルの両方を使用できます。

必要な権限

タグの管理に必要な権限を取得するため、 次の IAM ロールを付与するように管理者に依頼してください。

  • タグ閲覧者 （roles/resourcemanager.tagViewer） タグが適用されているリソースに対する
  • 組織レベルでタグを表示および管理する: 組織閲覧者 (roles/resourcemanager.organizationViewer) 組織に対する
  • タグの定義を作成、更新、削除する: Tag Administrator （roles/resourcemanager.tagAdmin） タグの作成、更新、削除を行うリソースに対する
  • リソースにタグを適用する、リソースからタグを削除する: Tag User （roles/resourcemanager.tagUser） タグの値、タグの値を適用または削除するリソースに対する

ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。

必要な権限は、カスタム ロールや他の事前定義 ロールから取得することもできます。

タグを Bigtable インスタンスに適用するには、 Bigtable 管理者ロール（roles/bigtable.admin）が必要です。

タグキーとタグ値を作成する

タグを適用する前に、タグを作成してその値を構成する必要があります。タグキーとタグ値を作成する方法については、タグの作成とタグ値の追加をご覧ください。

リソースの作成時にタグを追加する

インスタンスの作成時にタグを追加できます。 タグを追加すると、インスタンスの重要なメタデータをすぐに提供できるだけでなく、整理、費用追跡、ポリシーの自動適用にも役立ちます。

コンソール

コンソールで新しいインスタンスを作成するときに、タグを追加することはできません。代わりに gcloud CLI を使用してください。

gcloud

タグ付きのインスタンスを作成するには、 gcloud bigtable instances create コマンドと --tags フラグを使用します。詳細については、 インスタンスの作成をご覧ください。

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

既存のリソースにタグを追加する

既存のインスタンスにタグを追加する手順は次のとおりです。

gcloud

タグをインスタンスに適用するには、gcloud resource-manager tags bindings create コマンドを使用してタグ バインディング リソースを作成する必要があります。

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

以下を置き換えます。

  • TAGVALUE_NAME: リソースに適用するタグ値の永続 ID または 名前空間名（例: tagValues/567890123456）。
  • RESOURCE_ID: リソースの完全な ID です。リソースのタイプ（//bigtable.googleapis.com/）を識別するために API ドメイン名が含まれています。たとえば、projects/7890123456 のインスタンスにタグを適用する場合、完全な ID は //bigtable.googleapis.com/projects/7890123456/instances/instance-ID です。

リソースに適用されたタグを一覧表示する

インスタンスに直接適用されている、またはインスタンスによって継承されたタグ バインディングのリストを表示できます。

gcloud

リソースに適用されたタグ バインディングのリストを取得するには、gcloud resource-manager tags bindings list コマンドを使用します。

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

以下を置き換えます。

  • RESOURCE_ID: リソースの完全な ID です。リソースのタイプ（//bigtable.googleapis.com/）を識別するために API ドメイン名が含まれています。たとえば、projects/7890123456 のインスタンスにタグを適用する場合、完全な ID は //bigtable.googleapis.com/projects/7890123456/instances/instance-ID です。

次のようなレスポンスが返されます。

name: tagBindings/%2F%2Fcloudresourcemanager.googleapis.com%2Fprojects%2F7890123456/tagValues/567890123456
          tagValue: tagValues/567890123456
          resource: //bigtable.googleapis.com/projects/7890123456/instances/instance-ID

リソースからタグを削除する

インスタンスに直接アタッチされたタグを切断できます。継承されたタグは、同じキーと別の値を持つタグを適用することでオーバーライドできますが、削除することはできません。

gcloud

タグ バインディングを削除するには、gcloud resource-manager tags bindings delete コマンドを使用します。

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

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

  • TAGVALUE_NAME: 適用されるタグ値の永続 ID または 名前空間名（例: tagValues/567890123456）。
  • RESOURCE_ID: リソースの完全な ID です。リソースのタイプ（//bigtable.googleapis.com/）を識別するために API ドメイン名が含まれています。たとえば、projects/7890123456 のインスタンスにタグを適用する場合、完全な ID は //bigtable.googleapis.com/projects/7890123456/instances/instance-ID です。

タグキーとタグ値を削除する

タグキーまたは値の定義を削除する場合は、インスタンスからタグの適用が解除されていることを確認してください。タグ定義自体を削除する前に、既存のタグの適用（タグ バインディング）を削除する必要があります。タグキーとタグ値を削除するには、タグの削除をご覧ください。

Identity and Access Management の条件とタグ

タグと IAM Conditions を使用すると、階層内のユーザーに条件付きでロール バインディングを付与できます。条件付きロール バインディングを含む IAM ポリシーが適用されている場合、リソースに適用されたタグを変更または削除すると、そのリソースへのユーザー アクセスを削除できます。詳細については、Identity and Access Management の条件とタグをご覧ください。

次のステップ