Halaman ini menjelaskan cara melihat detail folder, memperbarui setelan folder, dan menghapus folder menggunakan Google Cloud konsol, Google Cloud CLI, atau API. Pelajari cara mengubah nama tampilan folder dan mengelola penempatan folder dalam hierarki organisasi Anda.
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 Google Cloud konsol, buka halaman Manage resources.
Daftar resource menampilkan hierarki Anda sebagai tabel. Pilih resource organisasi Anda.
Klik tanda panah di samping nama organisasi untuk meluaskan tampilan hierarki dan melihat folder turunannya.
Untuk melakukan tindakan, seperti memindahkan, menghapus, atau melihat setelan, klik Tindakan di akhir baris untuk resource tertentu tersebut.
Gunakan kolom Filter di bagian atas daftar resource untuk menelusuri resource berdasarkan nama, ID, atau label.
Menggunakan pemilih project
Gunakan pemilih project di menu navigasi atas untuk mengalihkan konteks aktif Anda ke project atau folder tertentu.
Di menu navigasi atas Google Cloud konsol, klik pemilih project. Ini adalah menu drop-down yang terletak di samping Google Cloud logo.
Di dialog yang muncul, pilih organisasi Anda dari drop-down untuk memfilter hasil.
Telusuri hierarki atau cari project atau folder yang ingin Anda alihkan. Mengklik resource di pemilih ini akan mengubah konteks global Anda, sehingga memengaruhi resource yang terlihat di halaman layanan lain (seperti Compute Engine atau Cloud Storage).
gcloud
Untuk mendapatkan detail satu folder, gunakan perintah 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 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 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 atau folder, gunakan perintah projects list dengan argumen 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 yang digunakan untuk membuat folder, seperti organizations/123 atau folders/123.
Memperbarui folder
Untuk memperbarui nama tampilan folder, Anda harus memiliki peran Folder Editor (roles/resourcemanager.folderEditor) atau peran Folder Admin (roles/resourcemanager.folderAdmin) di folder tersebut.
Konsol
Di Google Cloud konsol, buka halaman Manage resources.
Klik tanda 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:
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 Google Cloud folder
- 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 Google Cloud konsol, buka halaman Manage resources.
- Pilih resource organisasi Anda dari drop-down Organization di kiri atas halaman.
- Klik baris folder Anda untuk memilih folder dari daftar project dan folder.
- Klik menu opsi (elips vertikal) di baris, lalu klik Move.
- Klik Browse untuk memilih folder yang ingin Anda pindahkan.
- Klik Move.
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 di bawah 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 resource organisasi atau 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 yang digunakan untuk
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 Dapatkan Operasi:
curl -H "Authorization: Bearer ${bearer_token}" \
https://cloudresourcemanager.googleapis.com/v3/operations/fm.1234567890
Respons Dapatkan Operasi:
{
"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 Folder Editor (roles/resourcemanager.folderEditor) atau peran Folder Admin (roles/resourcemanager.folderAdmin) di folder tersebut.
Konsol
Di Google Cloud konsol, buka halaman Manage resources.
Di Google Cloud konsol, buka halaman Manage resources.Klik tanda 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.
Di dialog konfirmasi, ketik ID atau nama folder untuk mengonfirmasi, lalu klik Hapus.
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 Google Cloud folder
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 penghapusan sementara selama periode retensi 30 hari sebelum dihapus secara permanen, atau dihapus secara permanen.
Status penghapusan sementara: Selama periode retensi 30 hari, folder akan 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 menghapus folder dan metadatanya secara permanen. Tindakan ini tidak dapat diurungkan.
Membatalkan penghapusan: Jika tidak sengaja menghapus folder, Anda dapat memulihkannya dalam jangka waktu
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 Folder Editor (
roles/resourcemanager.folderEditor) atau Folder Admin (roles/resourcemanager.folderAdmin).
Telusuri
Untuk menelusuri folder yang cocok dengan kueri yang ditentukan, gunakan gcloud alpha resource-manager
folders search, dengan meneruskan kondisi dalam flag --query. Cakupan penelusuran adalah semua folder yang memiliki izin lihat oleh pengguna.
gcloud alpha resource-manager folders search --query="name:vij*"
<table output showing the folders with names starting from vij eg. vijeta, vijay-folder>
gcloud alpha resource-manager folders search --query="state:DELETE_REQUESTED"
<table output showing folders for which delete has been requested>
Semua folder yang memiliki izin lihat oleh pengguna dapat ditampilkan menggunakan perintah gcloud folders search.
gcloud folders search
<table output showing all viewable folders>
Langkah berikutnya
- Pelajari cara mengelola project dalam folder.
- Pelajari tentang peran dan izin untuk folder.