このページでは、ラベルの概要、シークレットにラベルを追加する方法、シークレットに適用されているラベルを表示および更新する方法について説明します。
ラベルとは
ラベルは、Google Cloud Secret Manager シークレットに割り当てることができる Key-Value ペアです。ラベルはこれらのリソースを整理し、必要な粒度に基づいてコストを大規模に管理する場合に役立ちます。各リソースにラベルを設定し、そのラベルに基づいてリソースをフィルタできます。ラベルに関する情報は課金システムに転送され、請求料金をラベル別に分類できます。組み込みの請求レポートにより、リソースラベルで費用をフィルタしてグループ化できます。また、ラベルを使用して請求データ エクスポートをクエリすることもできます。
ラベルの要件
リソースに適用するラベルは、次の要件を満たす必要があります。
- 各リソースには、最大 64 個のラベルを設定できます。
- ラベルは、Key-Value ペアでなければなりません。
- キーは 1 文字以上、63 文字までにする必要があります。空にすることはできません。値は 63 文字以下にします。空にすることもできます。
- キーと値には、小文字、数字、アンダースコア、ダッシュのみを使用できます。すべての文字は UTF-8 でエンコードする必要があります。国際文字も使用できます。キーは、小文字または国際文字で始める必要があります。
- ラベルのキー部分は、単一のリソース内では一意である必要があります。ただし、複数のリソースで同じキーを使用できます
これらの上限は、各ラベルのキーと値だけでなく、ラベルのある個々の Google Cloud リソースにも適用されます。1 つのプロジェクト内のすべてのリソースに適用できるラベルの数に上限はありません。
ラベルの一般的な用途
次に、ラベルの一般的な使用例を示します。
チームまたはコストセンターのラベル: チームやコストセンターに基づいてラベルを追加し、各チームが所有する Secret Manager のシークレットを区別します（例:
team:research、team:analytics）。この種類のラベルは、費用計算または予算作成に使用できます。コンポーネント ラベル:
component:redis、component:frontend、component:ingest、component:dashboardなど。環境ラベルまたはステージのラベル:
environment:production、environment:testなど。状態のラベル:
state:active、state:readytodelete、state:archiveなど。オーナー権限ラベル: 運用担当チームの識別に使用されます（例:
team:shopping-cart）。
すべての API 呼び出しにタイムスタンプや個別の値を設定するなど、一意のラベルを多数作成することはおすすめしません。このアプローチの問題は、値が頻繁に変更される場合やカタログを混乱させるキーを使用している場合に、リソースを効果的にフィルタして報告することが困難になることです。
ラベルとタグ
ラベルは、リソースに対するクエリ可能なアノテーションとして使用できますが、ポリシーの条件の設定には使用できません。タグを使用すると、ポリシーをきめ細かく制御することによって、リソースに特定のタグが付加されているかどうかに基づいて、条件付きでポリシーを許可または拒否することが可能になります。詳細については、タグの概要をご覧ください。
ラベル付きシークレットを作成する
シークレットの作成時にラベルを追加する手順は、次のとおりです。
Console
-
Google Cloud コンソールの [Secret Manager] ページに移動します。
-
[Secret Manager] ページで、[リージョン シークレット] タブをクリックし、[リージョン シークレットを作成] をクリックします。
-
[リージョン シークレットを作成] ページの [名前] フィールドに、シークレットの名前を入力します。
-
シークレットの値を入力します（例:
abcd1234）。[ファイルをアップロード] オプションを使用して、シークレット値を含むテキスト ファイルをアップロードすることもできます。このアクションにより、シークレット バージョンが自動的に作成されます。 -
[リージョン] リストから、リージョン シークレットを保存するロケーションを選択します。
-
[ラベル] セクションに移動し、[ラベルを追加] をクリックします。
-
キーと対応する値を入力してラベルを作成します。
-
[シークレットの作成] をクリックします。
シークレットのラベルを表示する
割り当てられたラベルを表示する手順は次のとおりです。
Console
-
Google Cloud コンソールの [Secret Manager] ページに移動します。
-
[Secret Manager] ページで、[リージョン シークレット] タブをクリックし、ラベルを表示するシークレットを選択します。
-
[情報パネル] が閉じている場合は、[情報パネルを表示] をクリックして表示します。
-
パネルで [ラベル] タブをクリックします。シークレットに追加されたすべてのラベルが表示されます。
ラベルの更新
ラベルを更新する手順は次のとおりです。
Console
-
Google Cloud コンソールの [Secret Manager] ページに移動します。
-
[Secret Manager] ページで、[リージョン シークレット] タブをクリックします。
-
編集するシークレットを選択します。
-
情報パネルを開き、[ラベル] タブをクリックします。
-
ラベルの既存の値を更新し、[保存] をクリックします。
既存のラベルを削除したり、新しいラベルを追加したりすることもできます。ラベルのキーを編集するには、同一のキー名で新しいラベルを追加して古いラベルを削除します。
ラベルを削除
ラベルを削除する手順は次のとおりです。
Console
-
Google Cloud コンソールの [Secret Manager] ページに移動します。
-
[Secret Manager] ページで、[リージョン シークレット] タブをクリックします。
-
編集するシークレットを選択します。
-
情報パネルを開き、[ラベル] タブをクリックします。
-
不要になったラベルを削除するには、[削除] をクリックします。
-
[保存] をクリックします。