Melihat, memperbarui, dan menghapus folder

Halaman ini menjelaskan cara melihat detail folder, memperbarui setelan folder, dan menghapus folder menggunakan konsol Google Cloud , 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 tampilannya, 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 tanda panah di samping nama organisasi untuk meluaskan tampilan hierarki dan melihat folder turunannya.

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

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

Menggunakan pemilih project

Gunakan pemilih project di menu navigasi atas untuk mengalihkan konteks aktif Anda ke project atau folder tertentu.

1. Di menu navigasi atas konsol Google Cloud , klik pemilih project. Ini adalah menu drop-down yang ada di samping logo Google Cloud.

2. Pada dialog yang muncul, pilih organisasi Anda dari drop-down untuk memfilter hasil.

3. Jelajahi hierarki atau telusuri 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).

   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.

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, 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 tempat Anda membuat folder, seperti organizations/123 atau folders/123.

Catatan: Perintah list dan metode API hanya menampilkan turunan langsung dari resource induk yang ditentukan. Tidak mencantumkan semua folder dan project secara rekursif di seluruh hierarki. Untuk melihat struktur bertingkat lengkap, Anda harus mencantumkan turunan setiap subfolder satu per satu atau menggunakan halaman Kelola resource di konsol Google Cloud .

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 tanda 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:

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: Google Cloud ID 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

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 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

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 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 pemindahan folder ke dalam folder lain di konsol mirip dengan pemindahan project.

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

   Buka Google Cloud konsol

2. Pilih resource organisasi Anda dari drop-down Organisasi di kiri atas halaman.
3. Klik baris folder Anda untuk memilih folder dari daftar proyek dan folder.
4. Klik menu opsi (elipsis vertikal) di baris, lalu klik Pindahkan.
5. Klik Jelajahi untuk memilih folder tujuan Anda ingin memindahkan folder.
6. Klik Pindahkan.

gcloud

Untuk memindahkan folder di 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 dalam 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 atau folder organisasi 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 menjadi tujuan pemindahan 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) di folder tersebut.

Catatan: Anda hanya dapat menghapus folder jika folder tersebut kosong (tidak berisi project atau subfolder).

Konsol

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

   Buka halaman Kelola resource

   Di konsol Google Cloud , buka halaman Manage resources.

2. Klik tanda 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 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: Google Cloud ID folder

Metode HTTP dan URL:

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

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.

Jalankan perintah berikut:

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://cloudresourcemanager.googleapis.com/v3/folders/FOLDER_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.

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 akan memasuki status dihapus sementara selama periode retensi 30 hari sebelum dihapus secara permanen, atau dihapus secara paksa.

Status hapus 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 folder dan metadatanya akan dihapus 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 mengurungkan 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 yang ditentukan, gunakan gcloud alpha resource-manager folders search, dengan meneruskan kondisi di flag --query. Cakupan penelusuran adalah semua folder yang izin lihatnya dimiliki 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 izin lihatnya dimiliki pengguna dapat ditampilkan menggunakan perintah gcloud folders search.

gcloud folders search
<table output showing all viewable folders>

Catatan: Perintah penelusuran dalam versi alfa dan dapat berubah tanpa pemberitahuan.

Langkah berikutnya

• Pelajari cara mengelola project dalam folder.
• Pelajari peran dan izin untuk folder.