Melihat, memperbarui, dan menghapus folder

Anda dapat melihat detail folder, memperbarui nama tampilan, memindahkan folder, dan menghapus folder yang tidak diperlukan menggunakan konsol Google Cloud , Google Cloud CLI, atau Cloud Resource Manager API. Dengan mengelola folder, Anda dapat mengatur resource dan mempertahankan hierarki resource Google Cloud seiring berkembangnya project dan tim.

Mencantumkan folder dan melihat detail folder

Untuk mencantumkan folder atau melihat metadata untuk folder tertentu, seperti nama tampilan, ID induk, dan status siklus prosesnya, Anda harus memiliki peran Folder Viewer (roles/resourcemanager.folderViewer) atau peran Organization Viewer (roles/resourcemanager.organizationViewer).

Konsol

  1. Di konsol Google Cloud , buka halaman Manage resources.

    Buka halaman Kelola resource

  2. Daftar resource menampilkan hierarki Anda sebagai tabel. Pilih resource organisasi Anda.

  3. Klik panah di samping nama organisasi untuk meluaskan tampilan hierarki dan melihat folder turunannya.

  4. Untuk melakukan tindakan, seperti memindahkan, menghapus, atau melihat setelan, klik Actions di akhir baris untuk resource tertentu tersebut.

  5. Gunakan panel Filter di bagian atas daftar resource untuk menelusuri resource berdasarkan nama, ID, atau label.

Untuk mengetahui informasi tentang cara halaman Mengelola resource menghitung stempel waktu Terakhir diakses untuk folder dan project, lihat Memahami stempel waktu Terakhir diakses.

Menggunakan pemilih project

Pemilih project terletak di menu navigasi dan bukan bagian dari antarmuka halaman Resource Manager utama. Gunakan perintah ini untuk mengalihkan konteks global aktif Anda ke project atau folder tertentu.

  1. Klik pemilih project. Pada dialog yang muncul, pilih organisasi Anda dari menu drop-down untuk memfilter hasil.

  2. Jelajahi hierarki atau telusuri project atau folder yang ingin Anda buka. Mengklik resource di pemilih ini akan mengubah konteks global Anda, sehingga memengaruhi resource mana yang terlihat di halaman layanan lain (seperti Compute Engine atau Cloud Storage).

gcloud

Untuk mendapatkan detail satu folder, gunakan perintah gcloud resource-manager folders describe:

gcloud resource-manager folders describe FOLDER_ID

Ganti FOLDER_ID dengan ID folder yang ingin Anda lihat.

Untuk mencantumkan folder turunan dari resource organisasi, gunakan perintah gcloud resource-manager folders list:

gcloud resource-manager folders list \
    --organization=ORGANIZATION_ID

Ganti ORGANIZATION_ID dengan ID resource organisasi yang ingin Anda lihat daftar folder turunannya.

Untuk mencantumkan folder turunan dari resource folder, gunakan perintah gcloud resource-manager folders list:

gcloud resource-manager folders list \
    --folder=FOLDER_ID

Ganti FOLDER_ID dengan ID resource folder yang ingin Anda lihat daftar folder turunannya.

Untuk mencantumkan project di bawah resource organisasi atau folder, gunakan perintah gcloud projects list dengan flag --filter:

gcloud projects list \
    --filter="parent.id='RESOURCE_ID'"

Ganti RESOURCE_ID dengan ID resource organisasi atau folder yang ingin Anda lihat daftar project turunannya.

REST

Permintaan curl untuk mendapatkan folder:

curl -X GET -H "Content-Type: application/json" \
  -H "Authorization: Bearer ${bearer_token}" \
  https://cloudresourcemanager.googleapis.com/v3/FOLDER_ID

Ganti FOLDER_NAME dengan nama folder, seperti folders/123.

Permintaan curl untuk mencantumkan folder:

curl -X GET -H "Content-Type: application/json" \
  -H "Authorization: Bearer ${bearer_token}" \
  https://cloudresourcemanager.googleapis.com/v3/folders?parent=PARENT_NAME

Ganti PARENT_NAME dengan nama resource induk tempat Anda membuat folder, seperti organizations/123 atau folders/123.

Memperbarui folder

Untuk memperbarui nama tampilan folder, Anda harus memiliki peran Editor Folder (roles/resourcemanager.folderEditor) atau peran Admin Folder (roles/resourcemanager.folderAdmin) di folder tersebut.

Konsol

  1. Di konsol Google Cloud , buka halaman Manage resources.

    Buka halaman Kelola resource

  2. Klik panah di samping nama organisasi untuk meluaskan tampilan hierarki dan melihat folder turunannya.

  3. Di baris folder yang ingin Anda perbarui, klik menu Tindakan di akhir baris, lalu klik Setelan.

  4. Masukkan nama folder baru, lalu klik Simpan.

gcloud

Untuk memperbarui nama tampilan folder, gunakan perintah gcloud resource-manager folders update:

gcloud resource-manager folders update FOLDER_ID \
   --display-name="NEW_DISPLAY_NAME"

Ganti kode berikut:

  • FOLDER_ID: ID folder yang ingin Anda perbarui.
  • NEW_DISPLAY_NAME: nama tampilan baru untuk folder.

REST

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • FOLDER_ID: ID folder Google Cloud
  • NEW_DISPLAY_NAME: nama tampilan baru untuk folder

Metode HTTP dan URL:

PATCH https://cloudresourcemanager.googleapis.com/v3/folders/FOLDER_ID?updateMask=displayName

Meminta isi JSON:

{
  "displayName": "NEW_DISPLAY_NAME"
}

Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:

curl

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

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

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 PATCH `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://cloudresourcemanager.googleapis.com/v3/folders/FOLDER_ID?updateMask=displayName" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

{
  "name": "operations/fc.1234567890abcdef",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.resourcemanager.v3.FolderOperationMetadata",
    "displayName": "NEW_DISPLAY_NAME",
    "operationType": "UPDATE",
    "resourceName": "folders/FOLDER_ID"
  },
  "done": false
}

Memindahkan folder ke folder lain

Untuk memindahkan folder ke folder lain, Anda harus memiliki izin resourcemanager.folders.move untuk folder sumber dan tujuan.

Konsol

Proses memindahkan folder ke folder lain di konsol mirip dengan memindahkan project.

  1. Di konsol Google Cloud , buka halaman Manage resources.

    Buka konsol Google Cloud

  2. Pilih resource organisasi Anda dari drop-down Organization di kiri atas halaman.
  3. Klik baris folder untuk memilih folder dari daftar project dan folder.
  4. Klik menu opsi (ellipsis vertikal) di baris, lalu klik Move.
  5. Klik Browse untuk memilih folder tujuan pemindahan folder.
  6. Klik Pindahkan.

gcloud

Untuk memindahkan folder di bawah resource organisasi, jalankan perintah berikut di Google Cloud CLI:

gcloud resource-manager folders move FOLDER_ID \
    --organization=PARENT_ID

Ganti kode berikut:

  • FOLDER_ID: ID folder yang ingin Anda pindahkan.
  • PARENT_ID: ID resource organisasi induk.

Untuk memindahkan folder ke folder lain:

gcloud resource-manager folders move FOLDER_ID \
    --folder=PARENT_ID

Ganti kode berikut:

  • FOLDER_ID: ID folder yang ingin Anda pindahkan.
  • PARENT_ID: ID folder induk.

REST

JSON permintaan:

request_json= '{
   destinationParent: "folders/DESTINATION_FOLDER_ID"
}'

Permintaan curl Pindahkan Folder:

curl -X POST -H "Content-Type: application/json" \
-H "Authorization: Bearer ${bearer_token} \
-d "$request_json" \
https://cloudresourcemanager.googleapis.com/v3/folders/DISPLAY_NAME:move

Ganti kode berikut:

  • DESTINATION_FOLDER_ID: ID folder tempat Anda memindahkan folder lain, misalnya 98765.
  • DISPLAY_NAME: nama tampilan folder yang dipindahkan, misalnya "My Awesome Folder".

Respons Pindahkan Folder:

{
  "name": "operations/fm.1234567890",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.resourcemanager.v3.FolderOperation",
    "displayName": "DISPLAY_NAME",
    "operationType": "MOVE"
  }
}

Permintaan curl Get Operation:

curl -H "Authorization: Bearer ${bearer_token}" \
https://cloudresourcemanager.googleapis.com/v3/operations/fm.1234567890

Respons Get Operation:

{
  "name": "operations/fm.1234567890",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.resourcemanager.v3.FolderOperation",
    "displayName": "DISPLAY_NAME",
    "operationType": "MOVE"
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.resourcemanager.v3.Folder",
    "name": "folders/12345",
    "parent": "folders/98765",
    "displayName": "DISPLAY_NAME",
    "lifecycleState": "ACTIVE",
    "createTime": "2017-07-19T23:29:26.018Z",
    "updateTime": "2017-07-20T00:54:44.295Z"
  }
}

Menghapus folder

Untuk menghapus folder, Anda harus memiliki peran Editor Folder (roles/resourcemanager.folderEditor) atau peran Admin Folder (roles/resourcemanager.folderAdmin) pada folder tersebut.

Konsol

  1. Di konsol Google Cloud , buka halaman Manage resources.

    Buka halaman Kelola resource

    Di konsol Google Cloud , buka halaman Manage resources.

  2. Klik panah di samping nama organisasi untuk meluaskan tampilan hierarki dan melihat folder turunannya.

  3. Di baris folder yang ingin Anda hapus, klik menu Tindakan di akhir baris, lalu klik Hapus.

  4. Pada dialog konfirmasi, ketik ID atau nama folder untuk mengonfirmasi, lalu klik Delete.

gcloud

Untuk menghapus folder, jalankan perintah berikut:

gcloud resource-manager folders delete FOLDER_ID

Ganti kode berikut:

  • FOLDER_ID: ID folder yang ingin Anda hapus.

REST

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • FOLDER_ID: ID folder Google Cloud

Metode HTTP dan URL:

DELETE https://cloudresourcemanager.googleapis.com/v3/folders/FOLDER_ID

Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:

curl

Jalankan perintah berikut:

curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://cloudresourcemanager.googleapis.com/v3/folders/FOLDER_ID"

PowerShell

Jalankan perintah berikut:

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

Invoke-WebRequest `
-Method DELETE `
-Headers $headers `
-Uri "https://cloudresourcemanager.googleapis.com/v3/folders/FOLDER_ID" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

{
  "name": "operations/fc.1234567890abcdef",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.resourcemanager.v3.FolderOperationMetadata",
    "operationType": "DELETE",
    "resourceName": "folders/FOLDER_ID"
  },
  "done": false
}

Informasi tambahan

Saat Anda menghapus folder, folder tersebut akan memasuki status dihapus sementara selama periode retensi 30 hari sebelum dihapus secara permanen, atau dihapus permanen.

Status penghapusan sementara: Selama periode retensi 30 hari, folder ditandai untuk dihapus dan tidak lagi aktif. Anda tidak dapat membuat project atau subfolder baru dalam folder yang dihapus sementara.

Status penghapusan permanen: Setelah 30 hari, Google Cloud akan menghapus folder dan metadatanya secara permanen. Tindakan ini tidak dapat diurungkan.

Membatalkan penghapusan: Jika tidak sengaja menghapus folder, Anda dapat memulihkannya dalam periode 30 hari menggunakan perintah gcloud resource-manager folders undelete atau API.

Prasyarat dan batasan

  • Folder harus kosong: Anda tidak dapat menghapus folder yang masih berisi project atau subfolder aktif. Anda harus memindahkan atau menghapus semua resource turunan terlebih dahulu.
  • Izin yang diperlukan: Untuk menghapus atau membatalkan penghapusan folder, Anda harus memiliki peran Editor Folder (roles/resourcemanager.folderEditor) atau Admin Folder (roles/resourcemanager.folderAdmin).

Telusuri

Untuk menelusuri folder yang cocok dengan kueri tertentu, gunakan perintah gcloud alpha resource-manager folders search dan teruskan kondisi penelusuran Anda dalam flag --query. Cakupan penelusuran mencakup semua folder yang izin aksesnya Anda miliki.

Misalnya, untuk menelusuri folder dengan nama tampilan yang diawali dengan vij, seperti vijeta atau vijay-folder, jalankan perintah berikut:

gcloud alpha resource-manager folders search --query="displayName:vij*"

Untuk menelusuri folder yang menunggu penghapusan, jalankan perintah berikut:

gcloud alpha resource-manager folders search --query="state:DELETE_REQUESTED"

Untuk menampilkan semua folder yang izinnya Anda miliki untuk dilihat, jalankan perintah gcloud alpha resource-manager folders search tanpa flag --query:

gcloud alpha resource-manager folders search

Langkah berikutnya