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

このドキュメントでは、gcloud CLI、Cloud Resource Manager API、 Cloud de Confiance コンソールを使用して プロジェクトのラベルを作成および更新する方法について説明します。

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

Console

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

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

    [ラベル] ページを開く

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

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

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

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

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

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

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

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

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

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

gcloud

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

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

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

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

ここで

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

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. コンソール Cloud de Confiance で [ラベル] ページを開きます。

    [ラベル] ページを開く

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

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

    1. ラベルを編集するには、編集する値をクリックして、必要な変更を加えます。
    2. をクリックします。
  4. ラベルの更新が完了したら、[保存] をクリックします。

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

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

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

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

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

    1. ラベルを編集するには、編集する値をクリックして、必要な変更を加えます。
    2. をクリックします。
  4. ラベルの更新が完了したら、[保存] をクリックします。

gcloud

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

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

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 です。