このページでは、AlloyDB for PostgreSQL リソースでタグの適用、切断、一覧表示を行う方法について説明します。AlloyDB のタグの概要については、タグを使用して AlloyDB リソースを整理するをご覧ください。
AlloyDB クラスタ リソースに適用されたタグは、インスタンスなどの子リソースに継承されます。これらの子リソースのタグはオーバーライドできません。詳細については、タグの継承をご覧ください。
始める前に
AlloyDB リソースのタグの表示と設定に必要な権限を取得するには、プロジェクトに対する次の IAM ロールを付与するよう管理者に依頼してください。
-
Cloud AlloyDB 管理者（
roles/alloydb.admin）: タグを設定して表示するユーザーに割り当てます。 -
Cloud AlloyDB 閲覧者（
roles/alloydb.viewer）: タグを表示するユーザーに割り当てます。
ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。
必要な権限は、カスタムロールや他の事前定義ロールから取得することもできます。
タグを操作する
Resource Manager を使用してタグを作成して定義したら、AlloyDB クラスタ リソースとバックアップ リソースでタグの使用を開始できます。タグ バインディングを使用する Google Cloud CLI コマンドの詳細については、gcloud resource-manager tags bindings をご覧ください。
このページのすべてのコマンドで、次のように置き換えます。
PARENT_PATH: バックアップまたはクラスタ リソースの完全なパス。例://alloydb.googleapis.com/projects/my-project/locations/us-central1/backups/my-backup。TAG_VALUE: リソースに適用するタグ値。たとえば、815471563813/environment/developmentとして設定されたタグ値には、次のコンポーネントが含まれています。815471563813は、組織 ID またはプロジェクト ID です。environmentはタグキーです。developmentはタグ値です。
LOCATION: クラスタまたはバックアップが配置されているリージョン。例:us-central1。
AlloyDB リソースにタグを適用する
gcloud resource-manager tags bindings create \ --parent=PARENT_PATH \ --tag-value=TAG_VALUE \ --location=LOCATION
AlloyDB リソースからタグを削除する
gcloud resource-manager tags bindings delete \ --parent=PARENT_PATH \ --tag-value=TAG_VALUE \ --location=LOCATION
AlloyDB リソースのタグを一覧取得する
gcloud resource-manager tags bindings list \ --parent=PARENT_PATH \ --location=LOCATION