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

このドキュメントでは、Resource Manager API と Google Cloud コンソールを使用してプロジェクトのラベルを作成および更新する方法について説明します。ラベルを使用して費用を把握する方法と、ラベルをサポートするサービスについて説明します。

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

Console

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

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

    [ラベル] ページを開く

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

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

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

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

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

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

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

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

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

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

REST

ラベルがある新しいプロジェクトを作成するには、プロジェクトの作成時にlabelsフィールドを設定します。

リクエスト:

POST https://cloudresourcemanager.googleapis.com/v3/projects

{
 "labels": {
  "color": "red"
 },
 "name": "myproject",
 "projectId": "our-project-123"
}

レスポンス:

{
 "projectNumber": "333197460082",
 "projectId": "our-project-123",
 "lifecycleState": "ACTIVE",
 "name": "myproject",
 "labels": {
  "color": "red"
 },
 "createTime": "2016-01-12T22:18:28.633Z",
}

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

  • projects.get() メソッドを使用してプロジェクトを取得します。
  • labels フィールドを変更します。
  • projects.patch() メソッドを使用して、プロジェクトを更新します。

ラベルを追加すると、ラベルに基づいてプロジェクトをフィルタできます。ラベルを使用してプロジェクトをフィルタリングする方法については、プロジェクトの一覧作成をご覧ください。

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

Console

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

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

    [ラベル] ページを開く

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

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

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

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

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

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

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

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

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

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

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

REST

プロジェクトのラベルを更新するには、次の操作を行います。

  • projects.get() メソッドを使用して、project オブジェクトを取得します。

  • 更新するラベルを修正します。

  • projects.patch メソッドを呼び出します。

次の例では、ラベル color:blue を更新します。

次のコード スニペットによって、color ラベルの値は blue から red に変更されます。

リクエスト:

PATCH https://cloudresourcemanager.googleapis.com/v3/projects/PROJECT_NAME
{
  updateMask=labels
}

プロジェクト名を PROJECT_NAME に更新したい場所。

JSON 本文のリクエスト:

{
    "labels":
      {
        "color": "red"
      }
}

レスポンス:

{
    "projects": [
    {
        "name": "projects/123456789012",
        "parent": "folders/123456789012",
        "projectId": "my-project",
        "state": "ACTIVE",
        "displayName": "PROJECT_NAME"
        "createTime": "2013-11-13T20:31:53.308Z"
        "updateTime": "2013-11-13T20:35:42.308Z"
        "etag": "BwWUlZ6XEfY="
        "labels": {
            "color": "red"
        },
    }
    ]
}