Melihat dan memperbarui project

Halaman ini menjelaskan cara mengambil metadata project dan mengubah setelan project yang ada. Anda juga dapat menelusuri project tertentu dalam hierarki resource berdasarkan status atau nama tampilannya.

Menemukan nama, nomor, dan ID project

Untuk berinteraksi dengan resource Google Cloud , Anda harus memberikan informasi pengenal project untuk setiap permintaan. Project diidentifikasi berdasarkan project ID dan nomor project-nya.

Konsol

Buka halaman Selamat Datang di konsol Google Cloud .
Buka Selamat Datang
Dari pemilih project di bagian atas halaman, pilih project Anda.

Catatan: Hingga 4.000 resource dapat ditampilkan di pemilih project. Jika Anda tidak melihat resource yang seharusnya muncul, buka halaman Kelola resource dan filter daftar menggunakan nama resource tersebut.

Nama project, nomor project, dan project ID muncul setelah heading Selamat datang.

Mendapatkan project yang ada

Untuk mendapatkan metadata mendetail dari project Google Cloud tertentu, seperti status siklus proses project, waktu pembuatan, dan resource induk, gunakan Google Cloud CLI atau API.

Anda harus memiliki status Pemilik Project atau izin peran Browser (roles/browser) untuk mengakses detail project.

gcloud

Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:

PROJECT_ID: Google Cloud project ID

Jalankan perintah berikut:

Linux, macOS, atau Cloud Shell

gcloud projects describe PROJECT_ID

Windows (PowerShell)

gcloud projects describe PROJECT_ID

Windows (cmd.exe)

gcloud projects describe PROJECT_ID

REST

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

PROJECT_ID: Google Cloud project ID

Metode HTTP dan URL:

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

Meminta isi JSON:

{}

Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:

curl

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

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

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

$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

Anda akan melihat respons JSON seperti berikut:

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

Mencantumkan semua project di bawah resource

Untuk mencantumkan semua project yang merupakan turunan langsung dari resource, gunakan metode v3 projects.list dan tentukan resource induk dalam kueri:

REST

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

FOLDER_ID: Google Cloud ID folder

Metode HTTP dan URL:

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

Meminta isi JSON:

{
    "parent": "folders/662951040570"
}

Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:

curl

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

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

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

$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

Anda akan melihat respons JSON seperti berikut:

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

Menelusuri project

Untuk menemukan project yang cocok dengan kriteria tertentu, seperti awalan nama tampilan atau status siklus proses tertentu, gunakan metode projects.search atau perintah gcloud alpha resource-manager projects search.

Cakupan penelusuran mencakup semua project yang izin resourcemanager.projects.get-nya Anda miliki.

Sintaksis kueri

Anda dapat memfilter penelusuran menggunakan flag --query (gcloud) atau parameter query (API). Filter penelusuran umum mencakup:

displayName: nama project yang mudah digunakan.
state: status siklus proses project, misalnya, ACTIVE atau DELETE_REQUESTED
parent.type dan parent.id: memfilter hasil menurut organisasi atau folder tertentu.

Izin

Jika Anda menentukan induk dalam kueri (misalnya, parent:folders/123), Anda harus memiliki izin resourcemanager.projects.list pada induk tersebut. Jika Anda memiliki izin ini, semua project di induk akan ditampilkan setelah filter yang tersisa diterapkan.

Jika Anda tidak memiliki izin ini, semua project yang memiliki izin resourcemanager.projects.get untuk Anda akan ditampilkan setelah filter lainnya diterapkan.

Jika Anda tidak menentukan induk, hasilnya akan mencakup semua project tempat Anda memiliki izin resourcemanager.projects.get.

gcloud

Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:

PROJECT_ID: Google Cloud project ID

Jalankan perintah berikut:

Linux, macOS, atau 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*"

Anda akan melihat respons seperti berikut:

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

REST

Metode HTTP dan URL:

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

Meminta isi JSON:

{}

Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:

curl

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

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

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

$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

Anda akan melihat respons JSON seperti berikut:

{
      "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="
        }
      ]
}

Memperbarui project

Anda dapat mengubah nama project, label, dan tag. Untuk mengetahui informasi selengkapnya tentang mengupdate project, lihat halaman referensi API project. Untuk memperbarui project, gunakan salah satu metode berikut:

Konsol

Untuk memperbarui nama atau label project menggunakan konsol Google Cloud , lakukan hal berikut:

Di konsol Google Cloud , buka halaman Setelan IAM & Admin.
Buka Setelan IAM & Admin

Langkah-langkah selanjutnya akan muncul di konsol Google Cloud .
Di bagian atas layar, klik menu drop-down pemilihan project.
Di jendela Pilih dari yang muncul, klik menu drop-down organisasi, lalu pilih organisasi Anda. Jika Anda adalah pengguna uji coba gratis, lewati langkah ini karena daftar organisasi tidak akan muncul.
Pilih project Anda dari daftar yang muncul.
Untuk mengubah nama project, edit Nama project, lalu klik Simpan.
Untuk menambahkan atau mengedit tag, buka bagian Tag di halaman, lalu klik Kelola tag. Untuk informasi tentang cara menambahkan atau memperbarui kunci dan nilai tag, lihat Membuat dan mengelola tag.
Untuk mengubah label, klik Label di menu kiri.
Pelajari lebih lanjut Menggunakan Label.

gcloud

Di konsol Google Cloud , aktifkan Cloud Shell.

Aktifkan Cloud Shell

Di bagian bawah konsol Google Cloud , sesi Cloud Shell akan dimulai dan menampilkan perintah command line. Cloud Shell adalah lingkungan shell dengan Google Cloud CLI yang sudah terinstal, dan dengan nilai yang sudah ditetapkan untuk project Anda saat ini. Diperlukan waktu beberapa detik untuk melakukan inisialisasi pada sesi.
Untuk memperbarui nama atau label project, gunakan perintah gcloud alpha projects update:
```
gcloud alpha projects update PROJECT_ID \
   --name=NAME \
   --update-labels=KEY=VALUE, ...
```
Ganti kode berikut:
- PROJECT_ID: ID project yang ingin Anda update.
- NAME: nama baru yang ingin Anda tetapkan ke project.
- KEY: kunci label yang ingin Anda perbarui.
- VALUE: nilai label yang ingin Anda perbarui.
Untuk mengetahui informasi selengkapnya dan flag tambahan yang dapat digunakan dengan perintah ini, lihat SDK Google Cloud CLI.

REST

Untuk memperbarui project, lakukan langkah-langkah berikut:

Dapatkan objek project menggunakan metode projects.get.
Ubah kolom yang ingin Anda perbarui.
Panggil metode projects.patch.

Contoh berikut memperbarui nama tampilan project menjadi myproject dan menetapkan label color menjadi red:

Permintaan:

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

Dengan PROJECT_NUMBER adalah ID numerik project yang ingin Anda perbarui.

Meminta isi JSON:

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

Respons:

{
  "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"
      }
    }
  ]
}

Langkah berikutnya

Pelajari cara memindahkan project dalam hierarki resource Anda.
Pelajari cara memigrasikan project dari satu resource organisasi ke resource organisasi lain.

Melihat dan memperbarui project Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Menemukan nama, nomor, dan ID project

Konsol

Mendapatkan project yang ada

gcloud

Linux, macOS, atau Cloud Shell

Windows (PowerShell)

Windows (cmd.exe)

REST

curl

PowerShell

Mencantumkan semua project di bawah resource

REST

curl

PowerShell

Menelusuri project

gcloud

Linux, macOS, atau Cloud Shell

Windows (PowerShell)

Windows (cmd.exe)

REST

curl

PowerShell

Memperbarui project

Konsol

gcloud

REST

Langkah berikutnya

Melihat dan memperbarui project