Managed Airflow（第 3 世代） | Managed Airflow（第 2 世代） | Managed Airflow（以前の第 1 世代）
このページでは、 Google Cloud のタグと、Managed Service for Apache Airflow での使用方法について説明します。
代わりに Managed Airflow 環境にラベルを追加する場合は、環境ラベルを管理して環境費用の内訳を調べるをご覧ください。
タグについて
タグは、Google Cloud内のリソースに適用できる Key-Value ペアです。タグを使用すると、リソースに特定のタグが付加されているかどうかに基づいて、条件付きでポリシーの許可や拒否を行うことができます。たとえば、リソースに特定のタグがあるかどうかに基づいて、Identity and Access Management（IAM）のロールを条件付きで付与できます。タグの詳細については、タグの概要をご覧ください。
タグは、タグと Google Cloud リソースを結びつけるタグ バインディング リソースを作成することによって、リソースに適用されます。
必要な権限
タグの管理に必要な権限を取得するため、次の IAM ロールを付与するように管理者に依頼してください。
- タグが適用されているリソースに対する タグ閲覧者 （
roles/resourcemanager.tagViewer） -
組織レベルでタグを表示および管理する: 組織に対する組織閲覧者 （
roles/resourcemanager.organizationViewer） -
タグの定義を作成、更新、削除する: タグの作成、更新、削除を行うリソースに対する Tag Administrator （
roles/resourcemanager.tagAdmin） -
リソースにタグを適用する、リソースからタグを削除する: タグの値、タグの値を適用または削除するリソースに対する Tag User （
roles/resourcemanager.tagUser）
ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。
必要な権限は、カスタムロールや他の事前定義ロールから取得することもできます。
タグを Managed Airflow 環境に適用するには、Composer 管理者ロール（roles/composer.admin）が必要です。
タグキーとタグ値を作成する
タグを適用する前に、タグを作成してその値を構成する必要があります。タグキーとタグ値を作成する方法については、タグの作成とタグ値の追加をご覧ください。
既存のリソースにタグを追加する
既存の環境にタグを追加する手順は次のとおりです。
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。リソースのタイプ（//composer.googleapis.com/）を識別するための API ドメイン名が含まれます。Managed Airflow 環境の完全な ID 形式は次のとおりです。
//composer.googleapis.com/projects/PROJECT_ID/locations/LOCATION/environments/ENVIRONMENT_NAME次のように置き換えます。
PROJECT_ID: 環境が配置されているプロジェクトのプロジェクト ID。LOCATION: 環境が配置されているリージョン。ENVIRONMENT_NAME: 環境の名前。
例:
//composer.googleapis.com/projects/7890123456/locations/us-central1/environments/example-environment。 LOCATION: リソースのロケーション。フォルダやプロジェクトなどのグローバル リソースにタグを適用する場合は、このフラグを省略します。リージョン リソースまたはゾーンリソースにタグを適用する場合は、us-central1（リージョン）やus-central1-a（ゾーン）などのロケーションを指定する必要があります。
リソースに適用されたタグを一覧表示する
環境に直接適用されているか、環境によって継承されているタグ バインディングのリストを表示できます。
gcloud
リソースに適用されたタグ バインディングのリストを取得するには、gcloud resource-manager tags bindings list コマンドを使用します。
gcloud resource-manager tags bindings list \
--parent=RESOURCE_ID \
--location=LOCATION
次のように置き換えます。
-
RESOURCE_ID: リソースの完全な ID。リソースのタイプ（//composer.googleapis.com/）を識別するための API ドメイン名が含まれます。Managed Airflow 環境の完全な ID 形式は次のとおりです。
//composer.googleapis.com/projects/PROJECT_ID/locations/LOCATION/environments/ENVIRONMENT_NAME次のように置き換えます。
PROJECT_ID: 環境が配置されているプロジェクトのプロジェクト ID。LOCATION: 環境が配置されているリージョン。ENVIRONMENT_NAME: 環境の名前。
例:
//composer.googleapis.com/projects/7890123456/locations/us-central1/environments/example-environment。 LOCATION: リソースのロケーション。フォルダやプロジェクトなどのグローバル リソースに適用されているタグを表示する場合は、このフラグを省略します。リージョン リソースまたはゾーンリソースに適用されているタグを表示する場合は、us-central1（リージョン）やus-central1-a（ゾーン） などのロケーションを指定する必要があります。
次のようなレスポンスが返されます。
name: tagBindings/%2F%2Fcloudresourcemanager.googleapis.com%2Fprojects%2F7890123456/tagValues/567890123456
tagValue: tagValues/567890123456
resource: //composer.googleapis.com/projects/7890123456/locations/us-central1/environments/example-environment
リソースからタグを削除する
環境に直接アタッチされたタグを解除できます。継承されたタグは、同じキーと別の値を持つタグを適用することでオーバーライドできますが、削除することはできません。
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。リソースのタイプ（//composer.googleapis.com/）を識別するための API ドメイン名が含まれます。Managed Airflow 環境の完全な ID 形式は次のとおりです。
//composer.googleapis.com/projects/PROJECT_ID/locations/LOCATION/environments/ENVIRONMENT_NAME次のように置き換えます。
PROJECT_ID: 環境が配置されているプロジェクトのプロジェクト ID。LOCATION: 環境が配置されているリージョン。ENVIRONMENT_NAME: 環境の名前。
例:
//composer.googleapis.com/projects/7890123456/locations/us-central1/environments/example-environment。 LOCATION: リソースのロケーション。フォルダやプロジェクトなどのグローバル リソースにタグを適用する場合は、このフラグを省略します。リージョン リソースまたはゾーンリソースにタグを適用する場合は、us-central1（リージョン）やus-central1-a（ゾーン）などのロケーションを指定する必要があります。
タグキーとタグ値を削除する
タグキーまたは値の定義を削除する場合は、タグが環境から切り離されていることを確認します。タグ定義自体を削除する前に、既存のタグの適用（タグ バインディング）を削除する必要があります。タグキーとタグ値を削除するには、タグの削除をご覧ください。
Identity and Access Management の条件とタグ
タグと IAM Conditions を使用すると、階層内のユーザーに条件付きでロール バインディングを付与できます。条件付きロール バインディングを含む IAM ポリシーが適用されている場合、リソースに適用されたタグを変更または削除すると、そのリソースへのユーザー アクセスを削除できます。詳細については、Identity and Access Management の条件とタグをご覧ください。
次のステップ
- タグをサポートするその他のサービス確認する。
- タグとアクセス制御で、IAM でタグを使用する方法を確認する。