このガイドでは、Workflows でワークフロー タグを作成して管理する方法について説明します。タグを使用すると、組織内のレポート、監査、アクセス制御のために、全体のワークフローやその他のリソースをグループ化できます。 Google Cloud Google Cloud
タグについて
タグは、Google Cloud内のリソースに適用できる Key-Value ペアです。タグを使用すると、リソースに特定のタグが付加されているかどうかに基づいて、条件付きでポリシーの許可や拒否を行うことができます。たとえば、リソースに特定のタグがあるかどうかに基づいて、Identity and Access Management（IAM）のロールを条件付きで付与できます。タグの詳細については、タグの概要をご覧ください。
タグは、タグと リソースを結びつけるタグ バインディング リソースを作成することによって、リソースに適用されます。 Google Cloud
自動化と課金のために Workflows 内でワークフローをグループ化する場合は、 ラベルを使用します。タグとラベルは互いに独立して機能するため、両方を同じワークフローに適用できます。タグとラベルの違いについて詳しくは、 タグとラベルをご覧ください。必要な権限
タグの管理に必要な権限を取得するため、 次の IAM ロールを付与するように管理者に依頼してください。
- タグ閲覧者 （
roles/resourcemanager.tagViewer） タグが適用されているリソースに対する -
組織レベルでタグを表示および管理する:
組織閲覧者 (
roles/resourcemanager.organizationViewer) 組織に対する -
タグの定義を作成、更新、削除する:
Tag Administrator (
roles/resourcemanager.tagAdmin) タグの作成、更新、削除を行うリソースに対する -
リソースにタグを適用する、リソースからタグを削除する:
Tag User (
roles/resourcemanager.tagUser) タグの値、タグの値を適用または削除するリソースに対する
ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。
必要な権限は、カスタム ロールや他の事前定義 ロールから取得することもできます。
タグを Workflows
ワークフローに適用するには、
Workflows 編集者
ロール（roles/workflows.editor）が必要です。
タグキーとタグ値を作成する
タグを適用する前に、タグを作成してその値を構成する必要があります。タグキーとタグ値を作成する方法については、タグの作成とタグ値の追加をご覧ください。
既存のリソースにタグを追加する
既存のワークフローにタグを追加する手順は次のとおりです。
コンソール
- [ワークフロー] ページに移動します。 Google Cloud
- タグを適用するワークフローを選択します。
- [Tags] をクリックします。
- 組織が [タグ] パネルに表示されない場合は、[スコープの選択] をクリックします。組織を選択して [開く] をクリックします。
- [タグを追加] をクリックします。
- リストから適用するタグのキーを選択します。リストは、キーワードを入力してフィルタできます。
- リストから付加するタグの値を選択します。リストは、キーワードを入力してフィルタできます。
- [保存] をクリックします。
- [確認] ダイアログで、[確認] をクリックしてタグを適用します。
タグが更新されたことは、通知によって確認します。
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 です。リソースのタイプ（//workflows.googleapis.com/）を識別するために API ドメイン名が含まれています。たとえば、projects/workflows-test-projectのワークフローmyWorkflow（リージョンus-central1）にタグを適用する場合、完全な ID は//workflows.googleapis.com/projects/workflows-test-project/locations/us-central1/workflows/myWorkflowです。 LOCATION: リソースの ロケーション。フォルダやプロジェクトなどのグローバル リソースにタグを適用する場合は、このフラグを省略します。リージョン リソースまたはゾーンリソースにタグを適用する場合は、us-central1（リージョン）やus-central1-a（ゾーン）などのロケーションを指定する必要があります。
リソースに適用されたタグを一覧表示する
ワークフローに直接適用されている、またはワークフローによって継承されたタグ バインディングのリストを表示できます。
コンソール
- [ワークフロー] ページに移動します。 Google Cloud
- タグは、ワークフローの [タグ] 列に表示されます。
gcloud
リソースに適用されたタグ バインディングのリストを取得するには、gcloud resource-manager tags bindings list コマンドを使用します。
gcloud resource-manager tags bindings list \
--parent=RESOURCE_ID \
--location=LOCATION
以下を置き換えます。
-
RESOURCE_IDはリソースの完全な ID です。リソースのタイプ（//workflows.googleapis.com/）を識別するために API ドメイン名が含まれています。たとえば、projects/workflows-test-projectのワークフローmyWorkflow（リージョンus-central1）にタグを適用する場合、完全な ID は//workflows.googleapis.com/projects/workflows-test-project/locations/us-central1/workflows/myWorkflowです。 LOCATION: リソースの ロケーション。フォルダやプロジェクトなどのグローバル リソースに適用されているタグを表示する場合は、このフラグを省略します。リージョン リソースまたはゾーンリソースに適用されているタグを表示する場合は、us-central1（リージョン）やus-central1-a（ゾーン） などのロケーションを指定する必要があります。
次のようなレスポンスが返されます。
name: tagBindings/%2F%2Fcloudresourcemanager.googleapis.com%2Fprojects%2F7890123456/tagValues/567890123456
tagValue: tagValues/567890123456
resource: //workflows.googleapis.com/projects/PROJECT_ID/locations/REGION/WORKFLOW_ID
リソースからタグを削除する
ワークフローに直接アタッチされたタグをデタッチできます。継承されたタグは、同じキーと別の値を持つタグを適用することでオーバーライドできますが、削除することはできません。
コンソール
- [ワークフロー] ページに移動します。 Google Cloud
- タグを削除するワークフローを選択します。
- [Tags] をクリックします。
- [タグ] パネルで、削除するタグの横にある [項目を削除] をクリックします。
- [保存] をクリックします。
- [確認] ダイアログで、[確認] をクリックしてタグを削除します。
タグが更新されたことは、通知によって確認します。
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 です。リソースのタイプ（//workflows.googleapis.com/）を識別するために API ドメイン名が含まれています。たとえば、projects/workflows-test-projectのワークフローmyWorkflow（リージョンus-central1）にタグを適用する場合、完全な ID は//workflows.googleapis.com/projects/workflows-test-project/locations/us-central1/workflows/myWorkflowです。 LOCATION: リソースの ロケーション。フォルダやプロジェクトなどのグローバル リソースにタグを適用する場合は、このフラグを省略します。リージョン リソースまたはゾーンリソースにタグを適用する場合は、us-central1（リージョン）やus-central1-a（ゾーン）などのロケーションを指定する必要があります。
タグキーとタグ値を削除する
タグキーまたは値の定義を削除する場合は、タグがワークフローから削除されていることを確認してください。タグ定義自体を削除する前に、既存のタグの適用（タグ バインディング）を削除する必要があります。タグキーとタグ値を削除するには、タグの削除をご覧ください。
Identity and Access Management の条件とタグ
タグと IAM Conditions を使用すると、階層内のユーザーに条件付きでロール バインディングを付与できます。条件付きロール バインディングを含む IAM ポリシーが適用されている場合、リソースに適用されたタグを変更または削除すると、そのリソースへのユーザー アクセスを削除できます。詳細については、Identity and Access Management の条件とタグをご覧ください。
次のステップ
- タグをサポートするその他のサービス確認する。
- タグとアクセス制御で、IAM でタグを使用する方法を確認する。