このページの一部またはすべての情報は、S3NS の Cloud de Confiance に適用されない場合があります。詳細については、Google Cloud との違いをご確認ください。

プロジェクトを表示、更新する

このページでは、プロジェクトのメタデータを取得し、既存のプロジェクト設定を変更する方法について説明します。リソース階層内の特定のプロジェクトを、状態または表示名に基づいて検索することもできます。

プロジェクト名、番号、ID を確認する

Cloud de Confiance by S3NS リソースとやり取りするには、リクエストごとにプロジェクト識別情報を提供する必要があります。プロジェクトはプロジェクト ID とプロジェクト番号で識別されます。

コンソール

Cloud de Confiance コンソールの [ようこそ] ページに移動します。
[ようこそ] に移動
ページ上部のプロジェクト選択ツールで、自分のプロジェクトを選択します。

注: プロジェクト選択ツールには最大 4,000 個のリソースを表示できます。表示されるはずのリソースが表示されない場合は、[リソースの管理] ページに移動し、そのリソースの名前を使用してリストをフィルタします。
プロジェクト名、プロジェクト番号、プロジェクト ID は [ようこそ] の見出しの後に表示されます。

既存のプロジェクトを取得する

プロジェクトのライフサイクル状態、作成時間、親リソースなど、特定の Cloud de Confiance by S3NS プロジェクトの詳細なメタデータを取得するには、Google Cloud CLI または API を使用します。

プロジェクトの詳細にアクセスするには、プロジェクトオーナーのステータスまたは参照者ロール（roles/browser）の権限が必要です。

gcloud

後述のコマンドデータを使用する前に、次のように置き換えます。

PROJECT_ID: Cloud de Confiance by S3NS プロジェクト ID

次のコマンドを実行します。

Linux、macOS、Cloud Shell

gcloud projects describe PROJECT_ID

Windows（PowerShell）

gcloud projects describe PROJECT_ID

Windows（cmd.exe）

gcloud projects describe PROJECT_ID

REST

リクエストのデータを使用する前に、次のように置き換えます。

PROJECT_ID: Cloud de Confiance by S3NS プロジェクト ID

HTTP メソッドと URL:

GET https://cloudresourcemanager.googleapis.com/v3/projects/PROJECT_ID

リクエストの本文（JSON）:

{}

リクエストを送信するには、次のいずれかのオプションを選択します。

curl

注: 次のコマンドは、gcloud init または gcloud auth login を実行して、ユーザーアカウントで gcloud CLI にログインしているか、Cloud Shell を使用して自動的に gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://cloudresourcemanager.googleapis.com/v3/projects/PROJECT_ID"

PowerShell

注: 次のコマンドは、gcloud init または gcloud auth login を実行して、ご自分のユーザーアカウントで gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://cloudresourcemanager.googleapis.com/v3/projects/PROJECT_ID" | Select-Object -Expand Content

次のような JSON レスポンスが返されます。

{
    "projectNumber": "464036093014",
    "projectId": "our-project-123",
    "lifecycleState": "ACTIVE",
    "name": "my project",
    "labels": {
        "mylabel": "prod"
    },
    "createTime": "2016-01-07T21:59:43.314Z"
}

リソースのすべてのプロジェクトの一覧表示

リソースの直接の子であるすべてのプロジェクトを一覧表示するには、v3 projects.list メソッドを使用し、クエリで親リソースを指定します。

REST

リクエストのデータを使用する前に、次のように置き換えます。

FOLDER_ID: Cloud de Confiance by S3NS フォルダ ID

HTTP メソッドと URL:

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

リクエストの本文（JSON）:

{
    "parent": "folders/662951040570"
}

リクエストを送信するには、次のいずれかのオプションを選択します。

curl

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://cloudresourcemanager.googleapis.com/v3/projects"

PowerShell

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://cloudresourcemanager.googleapis.com/v3/projects" | Select-Object -Expand Content

次のような JSON レスポンスが返されます。

{
    "projectNumber": "464036093014",
    "projectId": "our-project-123",
    "lifecycleState": "ACTIVE",
    "name": "my project",
    "labels": {
        "mylabel": "prod"
    },
    "createTime": "2016-01-07T21:59:43.314Z"
}

プロジェクトを検索

表示名の接頭辞や特定のライフサイクル状態などの特定の条件に一致するプロジェクトを見つけるには、projects.search メソッドまたは gcloud alpha resource-manager projects search コマンドを使用します。

検索の範囲には、resourcemanager.projects.get 権限が付与されているすべてのプロジェクトが含まれます。

クエリ構文

検索結果をフィルタするには、--query フラグ（gcloud）または query パラメータ（API）を使用します。一般的な検索フィルタは次のとおりです。

displayName: プロジェクトのわかりやすい名前。
state: プロジェクトのライフサイクル状態（ACTIVE、DELETE_REQUESTED など）
parent.type と parent.id: 特定の組織またはフォルダで結果をフィルタします。

権限

クエリで親（parent:folders/123 など）を指定する場合は、その親に対する resourcemanager.projects.list 権限が必要です。この権限がある場合、親の下にあるすべてのプロジェクトが、残りのフィルタが適用された後に返されます。

この権限がない場合は、resourcemanager.projects.get 権限を持っているすべてのプロジェクトが、残りのフィルタが適用された後に返されます。

親を指定しない場合、結果には resourcemanager.projects.get 権限を持つすべてのプロジェクトが含まれます。

gcloud

後述のコマンドデータを使用する前に、次のように置き換えます。

PROJECT_ID: Cloud de Confiance by S3NS プロジェクト ID

次のコマンドを実行します。

Linux、macOS、Cloud Shell

gcloud alpha projects search --query="name:z*"

Windows（PowerShell）

gcloud alpha projects search --query="name:z*"

Windows（cmd.exe）

gcloud alpha projects search --query="name:z*"

次のようなレスポンスが返されます。

The response contains the projects with names starting with 'z'

REST

HTTP メソッドと URL:

GET https://cloudresourcemanager.googleapis.com/v3/projects:search?query=displayName%3ATokyo%2BRain

リクエストの本文（JSON）:

{}

リクエストを送信するには、次のいずれかのオプションを選択します。

curl

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://cloudresourcemanager.googleapis.com/v3/projects:search?query=displayName%3ATokyo%2BRain"

PowerShell

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://cloudresourcemanager.googleapis.com/v3/projects:search?query=displayName%3ATokyo%2BRain" | Select-Object -Expand Content

次のような JSON レスポンスが返されます。

{
      "projects": [
        {
          "name": "projects/951040570662",
          "parent": "folders/662951040570",
          "projectId": "tokyo-rain-123",
          "state": "ACTIVE",
          "displayName": "Tokyo Rain",
          "createTime": "2013-11-13T20:31:53.308Z",
          "updateTime": "2013-11-13T20:31:53.308Z",
          "etag": "BwWUlZ6XEfY="
        }
      ]
}

プロジェクトを更新する

プロジェクト名、ラベル、タグを変更できます。プロジェクトの更新の詳細については、プロジェクト API リファレンスページをご覧ください。プロジェクトを更新するには、次のいずれかの方法を使用します。

コンソール

Cloud de Confiance コンソールを使用してプロジェクトの名前またはラベルを更新するには、次の操作を行います。

Cloud de Confiance コンソールで、[IAM と管理] の [設定] ページに移動します。
[IAM と管理] の [設定] に移動

残りの手順は、 Cloud de Confiance コンソールに表示されます。
ページ上部にある「プロジェクトの選択」プルダウンリストをクリックします。
表示された [選択元] ウィンドウで、組織プルダウンリストをクリックして、組織を選択します。無料トライアルをご使用の場合は、組織リストが表示されないため、この手順はスキップしてください。
表示されたリストからプロジェクトを選択します。
プロジェクト名を変更するには、プロジェクト名を編集し、[保存] をクリックします。
タグを追加または編集するには、ページの [タグ] セクションに移動し、[タグを管理] をクリックします。タグキーとタグ値の追加または更新については、タグの作成と管理をご覧ください。
ラベルを変更するには、左側のナビゲーションで [ラベル] をクリックします。
ラベルの使用の詳細。

gcloud

Cloud de Confiance コンソールで Cloud Shell をアクティブにします。

Cloud Shell をアクティブにする

Cloud de Confiance コンソールの下部にある Cloud Shell セッションが開始し、コマンドラインプロンプトが表示されます。Cloud Shell はシェル環境です。Google Cloud CLI がすでにインストールされており、現在のプロジェクトの値もすでに設定されています。セッションが初期化されるまで数秒かかることがあります。
プロジェクトの名前またはラベルを更新するには、gcloud alpha projects update コマンドを使用します。
```
gcloud alpha projects update PROJECT_ID \
   --name=NAME \
   --update-labels=KEY=VALUE, ...
```
次のように置き換えます。
- PROJECT_ID: 更新するプロジェクトの ID。
- NAME: プロジェクトに割り当てる新しい名前。
- KEY: 更新するラベルのキー。
- VALUE: 更新するラベルの値。
このコマンドの詳細情報および使用できるその他のフラグについては、Google Cloud CLI SDK をご覧ください。

REST

プロジェクトを更新するには、次のとおりにします。

projects.get メソッドを使用して、project オブジェクトを取得します。
更新対象の項目を変更します。
projects.patch メソッドを呼び出します。

次の例では、プロジェクトの表示名を myproject に更新し、color ラベルを red に設定します。

リクエスト:

PATCH https://cloudresourcemanager.googleapis.com/v3/projects/PROJECT_NUMBER?updateMask=displayName,labels

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

JSON 本文のリクエスト:

{
  "displayName": "myproject",
  "labels": {
    "color": "red"
  }
}

対応:

{
  "projects": [
    {
      "name": "projects/951054970012",
      "parent": "folders/662951040570",
      "projectId": "Osaka-rain-234",
      "state": "ACTIVE",
      "displayName": "myproject",
      "createTime": "2013-11-13T20:31:53.308Z",
      "updateTime": "2013-11-13T20:35:42.308Z",
      "etag": "BwWUlZ6XEfY=",
      "labels": {
        "color": "red"
      }
    }
  ]
}

次のステップ

リソース階層内でプロジェクトを移動する方法を確認する。
組織リソース間でプロジェクトを移行する方法について学習する。