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
Di konsol Google Cloud , buka halaman Manage resources.
Daftar resource menampilkan hierarki Anda sebagai tabel. Pilih resource organisasi Anda.
Klik panah di samping nama organisasi untuk meluaskan tampilan hierarki dan melihat folder turunannya.
Untuk melakukan tindakan, seperti memindahkan, menghapus, atau melihat setelan, klik Actions di akhir baris untuk resource tertentu tersebut.
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.
Klik pemilih project. Pada dialog yang muncul, pilih organisasi Anda dari menu drop-down untuk memfilter hasil.
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
Di konsol Google Cloud , buka halaman Manage resources.
Klik panah di samping nama organisasi untuk meluaskan tampilan hierarki dan melihat folder turunannya.
Di baris folder yang ingin Anda perbarui, klik menu Tindakan di akhir baris, lalu klik Setelan.
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.
- Di konsol Google Cloud , buka halaman Manage resources.
- Pilih resource organisasi Anda dari drop-down Organization di kiri atas halaman.
- Klik baris folder untuk memilih folder dari daftar project dan folder.
- Klik menu opsi (ellipsis vertikal) di baris, lalu klik Move.
- Klik Browse untuk memilih folder tujuan pemindahan folder.
- 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
Di konsol Google Cloud , buka halaman Manage resources.
Di konsol Google Cloud , buka halaman Manage resources.Klik panah di samping nama organisasi untuk meluaskan tampilan hierarki dan melihat folder turunannya.
Di baris folder yang ingin Anda hapus, klik menu Tindakan di akhir baris, lalu klik Hapus.
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
- Pelajari cara mengelola project dalam folder.
- Pelajari peran dan izin untuk folder.