プロジェクトのラベルを作成および更新する

ラベルを使用すると、 Google Cloud プロジェクトを整理し、チームや環境間で費用を追跡できます。プロジェクト ラベルを管理するには、Google Cloud コンソール、Google Cloud CLI、または Cloud Resource Manager API を使用します。

ラベルはプロジェクトにのみ適用されます。フォルダと組織リソースはラベルをサポートしていません。プロジェクトに適用したラベルは、子リソースに自動的に伝播されません。Compute Engine インスタンスや Cloud Storage バケットなどの特定のサービス リソースにラベルを適用または更新するには、リソースのドキュメントまたはラベルをサポートするサービスをご覧ください。たとえば、Pub/Sub はトピックとサブスクリプションのスループット課金のラベルをサポートしていますが、下り（外向き）課金 SKU はラベルをサポートしていません。

プロジェクトのラベルを作成する

Console

単一のプロジェクトにラベルを追加するには:

  1. Google Cloud コンソールで [ラベル] ページを開きます。

    [ラベル] ページを開く

  2. [プロジェクトを選択] プルダウンからプロジェクトを選択します。

  3. 新しいラベルエントリを追加するには、[+ ラベルを追加] をクリックして、追加するラベルのラベルキーと値を入力します。

  4. ラベルの追加が完了したら、[保存] をクリックします。

同時に複数のプロジェクトにラベルを追加するには:

  1. Google Cloud コンソールで [リソースの管理] ページを開きます。

    [リソースの管理] ページを開く

  2. [リソースの管理] ページで、ラベルを追加したいプロジェクトを選択します。

  3. 情報パネルの [ラベル] タブで [+ ラベルを追加] をクリックして、追加したい各ラベルのラベルキーと値を入力します。

  4. ラベルの追加が完了したら、[保存] をクリックします。

ラベルの追加後、プロジェクト リストの上にあるフィルタ ボックスにラベルキーまたは値を入力すると、プロジェクトをフィルタリングできます。フィルタ ボックスにキーと値が表示され、結果をプレビューできます。

gcloud

gcloud CLI を使用してラベル付きの新しいプロジェクトを作成するには、--labels フラグを指定して gcloud projects create コマンドを使用します。

gcloud projects create PROJECT_ID \
    --labels=KEY1=VALUE1,KEY2=VALUE2

既存のプロジェクトにラベルを追加するには、--update-labels フラグを指定して gcloud projects update コマンドを使用します。

gcloud projects update PROJECT_ID \
    --update-labels=KEY1=VALUE1,KEY2=VALUE2

ここで

  • PROJECT_ID は、作成または更新するプロジェクトの ID です。
  • KEY1=VALUE1 は、追加するラベルの Key-Value ペアです。

REST

ラベルがある新しいプロジェクトを作成するには、projects.create メソッドに POST リクエストを送信する際に、labels フィールドを含めます。

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "projectId": "PROJECT_ID",
    "displayName": "PROJECT_NAME",
    "labels": {
      "environment": "development"
    }
  }' \
  "https://cloudresourcemanager.googleapis.com/v3/projects"

既存のプロジェクトにラベルを追加するには、projects.patch メソッドを使用します。

curl -X PATCH \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "labels": {
      "environment": "development"
    }
  }' \
  "https://cloudresourcemanager.googleapis.com/v3/projects/PROJECT_ID?updateMask=labels"

プロジェクトのラベルを更新する

Console

1 つのプロジェクトのラベルを更新するには:

  1. Google Cloud コンソールで [ラベル] ページを開きます。

    [ラベル] ページを開く

  2. [プロジェクトを選択] プルダウンからプロジェクトを選択します。

  3. プロジェクトのラベルを更新します。

    1. ラベルを編集するには、編集する値をクリックして、必要な変更を加えます。
    2. をクリックします。

  4. ラベルの更新が完了したら、[保存] をクリックします。

同時に複数のプロジェクトのラベルを更新するには:

  1. Google Cloud コンソールで [リソースの管理] ページを開きます。

    [リソースの管理] ページを開く

  2. [リソースの管理] ページで、ラベルを更新するプロジェクトを選択します。

  3. 情報パネルで [ラベル] タブをクリックして、選択したプロジェクトのラベルを更新します。

    1. ラベルを編集するには、編集する値をクリックして、必要な変更を加えます。
    2. をクリックします。

  4. ラベルの更新が完了したら、[保存] をクリックします。

gcloud

gcloud CLI を使用してプロジェクトのラベルを更新するには、--update-labels、--remove-labels、または --clear-labels フラグを指定して gcloud projects update コマンドを使用します。

ラベルを追加または更新するには:

gcloud projects update PROJECT_ID \
    --update-labels=KEY1=VALUE1,KEY2=VALUE2

特定のラベルを削除するには:

gcloud projects update PROJECT_ID \
    --remove-labels=KEY1,KEY2

プロジェクトからすべてのラベルを削除するには:

gcloud projects update PROJECT_ID \
    --clear-labels

REST

API を使用してプロジェクトのラベルを更新するには、projects.patch メソッドに PATCH リクエストを送信します。

curl -X PATCH \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "labels": {
      "color": "red"
    }
  }' \
  "https://cloudresourcemanager.googleapis.com/v3/projects/PROJECT_ID?updateMask=labels"

ここで、PROJECT_ID は更新するプロジェクトの ID です。