このページは Cloud Translation API によって翻訳されました。

タグを管理

このページでは、ストリーム、接続プロファイル、プライベート接続などの Datastream リソースにタグを付加、解除、一覧表示する方法について説明します。Datastream のタグの概要については、タグを使用したアクセス制御をご覧ください。

タグについて

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

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

自動化と課金の目的で Datastream 内のストリーム、接続プロファイル、プライベート接続をグループ化するには、ラベルを使用します。タグとラベルは互いに独立して機能するため、両方をリソースに適用できます。

必要な権限

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

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

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

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

タグを Datastream リソースに付加するには、Datastream 管理者ロール（roles/datastream.admin）か、次の権限を含む別のロールが必要です。

必要な権限

datastream.connectionProfiles.createTagBinding
datastream.connectionProfiles.deleteTagBinding
datastream.connectionProfiles.listTagBindings
datastream.connectionProfiles.listEffectiveTags
datastream.streams.createTagBinding
datastream.streams.deleteTagBinding
datastream.streams.listTagBindings
datastream.streams.listEffectiveTags
datastream.privateConnections.createTagBinding
datastream.privateConnections.deleteTagBinding
datastream.privateConnections.listTagBindings
datastream.privateConnections.listEffectiveTags

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

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

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

既存のストリーム、接続プロファイル、プライベート接続にタグを追加する手順は次のとおりです。

Console

Google Cloud コンソールの [Datastream] ページに移動します。

Datastream に移動

タグを付加するリソースのページを選択します。たとえば、接続プロファイルにタグを付加するには、[接続プロファイル] ページに移動します。
[タグ] をクリックします。
組織が [タグ] パネルに表示されない場合は、[スコープの選択] をクリックします。組織を選択して [開く] をクリックします。
[タグを追加] をクリックします。
リストから適用するタグのキーを選択します。リストは、キーワードを入力してフィルタできます。
リストから付加するタグの値を選択します。リストは、キーワードを入力してフィルタできます。
[保存] をクリックします。
[確認] ダイアログで、[確認] をクリックしてタグを適用します。

タグが更新されたことは、通知によって確認します。

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 で、リソースのタイプ（//datastream.googleapis.com/）を識別するために API ドメイン名が含まれています。たとえば、projects/PROJECT_NAME/streams/STREAM_NAME のインスタンスにタグを付加する場合、完全な ID は //datastream.googleapis.com/projects/PROJECT_NAME/streams/STREAM_NAME です。
LOCATION: リソースのロケーション。フォルダやプロジェクトなどのグローバルリソースにタグを適用する場合は、このフラグを省略します。リージョンリソースまたはゾーンリソースにタグを適用する場合は、us-central1（リージョン）や us-central1-a（ゾーン）などのロケーションを指定する必要があります。

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

ストリーム、接続プロファイル、またはプライベート接続に直接付加された、またはこれらによって継承されたタグバインディングのリストを表示できます。

Console

Google Cloud コンソールの [Datastream] ページに移動します。

Datastream に移動

タグを表示するリソースのページを選択します。たとえば、接続プロファイルのタグを表示するには、[接続プロファイル] ページに移動します。

タグは、ストリーム、接続プロファイル、プライベート接続の [タグ] 列に表示されます。

gcloud

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

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

以下を置き換えます。

RESOURCE_ID はリソースの完全な ID で、リソースのタイプ（//datastream.googleapis.com/）を識別するために API ドメイン名が含まれています。たとえば、projects/PROJECT_NAME/streams/STREAM_NAME のインスタンスにタグを付加する場合、完全な ID は //datastream.googleapis.com/projects/PROJECT_NAME/streams/STREAM_NAME です。
LOCATION: リソースのロケーション。フォルダやプロジェクトなどのグローバルリソースに適用されているタグを表示する場合は、このフラグを省略します。リージョンリソースまたはゾーンリソースに適用されているタグを表示する場合は、us-central1（リージョン）や us-central1-a（ゾーン）などのロケーションを指定する必要があります。

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

name: tagBindings/%2F%2Fcloudresourcemanager.googleapis.com%2Fprojects%2F7890123456/tagValues/567890123456
          tagValue: tagValues/567890123456
          resource: //datastream.googleapis.com/projects/project-abc/streams/stream-xyz<

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

ストリーム、接続プロファイル、プライベート接続に直接付加されたタグを解除できます。継承されたタグは、同じキーと別の値を持つタグを適用することでオーバーライドできますが、削除することはできません。

Console

Google Cloud コンソールの [Datastream] ページに移動します。

Datastream に移動

タグを削除するリソースのページを選択します。たとえば、接続プロファイルからタグを削除するには、[接続プロファイル] ページに移動します。
[タグ] をクリックします。
[タグ] パネルで、削除するタグの横にある [項目を削除] をクリックします。
[保存] をクリックします。
[確認] ダイアログで、[確認] をクリックしてタグを削除します。

タグが更新されたことは、通知によって確認します。

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 で、リソースのタイプ（//datastream.googleapis.com/）を識別するために API ドメイン名が含まれています。たとえば、projects/PROJECT_NAME/streams/STREAM_NAME のインスタンスにタグを付加する場合、完全な ID は //datastream.googleapis.com/projects/PROJECT_NAME/streams/STREAM_NAME です。
LOCATION: リソースのロケーション。フォルダやプロジェクトなどのグローバルリソースにタグを適用する場合は、このフラグを省略します。リージョンリソースまたはゾーンリソースにタグを適用する場合は、us-central1（リージョン）や us-central1-a（ゾーン）などのロケーションを指定する必要があります。

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

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

Identity and Access Management の条件とタグ

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

次のステップ

タグをサポートするその他のサービス確認する。
タグとアクセス制御で、IAM でタグを使用する方法を確認する。