Folder terkelola

Halaman ini memberikan ringkasan tentang folder terkelola di Cloud Storage. Folder terkelola adalah jenis folder yang dapat Anda beri peran IAM, sehingga Anda memiliki kontrol akses yang lebih terperinci atas grup objek tertentu dalam bucket. Folder terkelola ada sebagai resource dalam Cloud Storage dan berbeda dengan folder simulasi, yang beroperasi dengan namespace datar.

IAM untuk folder terkelola

Saat Anda menerapkan kebijakan IAM pada folder terkelola, akses yang diberikan dalam kebijakan tersebut berlaku untuk objek apa pun dalam bucket yang menggunakan jalur folder terkelola sebagai awalan dalam nama objek. Misalnya, jika Anda memberikan peran Storage Object Viewer (roles/storage.objectViewer) kepada akun utama di folder terkelola bernama example-managed-folder/, akun utama tersebut dapat melihat objek apa pun dalam jalur example-managed-folder, seperti example-managed-folder/dog.png atau example-managed-folder/cat.jpeg. Saat Anda menyusun folder terkelola secara bertingkat, izin yang diberikan melalui kebijakan IAM diterapkan secara aditif.

Kebijakan penolakan IAM tidak dapat ditetapkan pada bucket atau folder terkelola. Sebagai gantinya, peran ini hanya dapat ditetapkan pada resource project, folder, dan organisasi. Selain itu, folder terkelola tidak dapat ditentukan sebagai resource dalam kondisi kebijakan penolakan IAM. Kondisi penolakan hanya mengenali fungsi tag resource, dan tag tidak dapat dilampirkan ke folder terkelola.

Folder terkelola hanya dapat dibuat di bucket yang telah mengaktifkan akses level bucket yang seragam.

Baca halaman berikut untuk mengetahui informasi selengkapnya tentang folder terkelola:

Nama folder terkelola

Nama yang Anda berikan ke folder terkelola harus memenuhi persyaratan berikut:

  • Nama folder terkelola dapat berisi urutan karakter Unicode yang valid, dengan panjang 1-1.024 byte jika berenkode UTF-8.

  • Nama folder terkelola tidak boleh berisi karakter Enter atau Line Feed.

  • Nama folder terkelola harus diakhiri dengan /. Nama folder terkelola dapat memiliki maksimal 15 /. Dengan kata lain, folder terkelola dapat disusun bertingkat hingga 15 tingkat.

  • Nama folder terkelola tidak boleh diawali dengan .well-known/acme-challenge/.

  • Folder terkelola tidak boleh diberi nama . atau ...

Sebaiknya hindari hal-hal berikut dalam nama folder terkelola Anda:

  • Karakter kontrol yang tidak sah di XML 1.0 (#x7F–#x84 dan #x86–#x9F): karakter ini menyebabkan masalah pencantuman XML saat Anda mencoba mencantumkan folder terkelola.

  • Karakter [, ], *, atau ?: Google Cloud CLI menginterpretasikan karakter ini sebagai karakter pengganti, sehingga menyertakannya dalam nama folder terkelola dapat mempersulit atau tidak memungkinkan untuk melakukan operasi karakter pengganti dengan alat tersebut. Selain itu, * dan ? bukan karakter yang valid untuk nama file di Windows.

  • Informasi identitas pribadi (PII) atau sensitif: nama folder terkelola terlihat lebih luas daripada data objek. Misalnya, nama folder terkelola muncul di URL untuk objek dan saat mencantumkan objek di dalam bucket.

Pertimbangan

Saat menggunakan folder terkelola, perhatikan pertimbangan berikut:

  • Folder terkelola dapat dibuat sebagai pengganti folder simulasi, yang berarti Anda dapat membuat folder terkelola dan menamainya sesuai dengan awalan objek, asalkan belum ada folder terkelola yang menggunakan nama tersebut. Misalnya, Anda dapat membuat folder terkelola bernama my-folder/, meskipun Anda sudah memiliki objek bernama my-folder/object.txt. Perhatikan bahwa kebijakan IAM pada folder terkelola my-folder/ kemudian akan berlaku untuk semua objek yang memiliki my-folder/ sebagai awalan nama.

  • Anda dapat membuat folder turunan terkelola sebelum folder induk terkelola dibuat. Misalnya, Anda dapat membuat folder terkelola bernama my-folder-A/my-folder-B/ tanpa membuat folder terkelola bernama my-folder-A/ terlebih dahulu.

  • Secara default, Anda tidak dapat menghapus folder terkelola yang tidak kosong dan berisi objek atau folder terkelola turunan lainnya. Anda dapat mengabaikan aturan ini saat menggunakan parameter allowNonEmpty dalam permintaan JSON API Delete ManagedFolder.

  • Nama folder terkelola terlihat dalam pesan error dan Cloud Audit Logs saat permintaan untuk menghapus folder yang memiliki folder terkelola di jalur yang sama gagal, bahkan tanpa izin storage.managedFolders.get atau storage.managedFolders.list eksplisit.

Langkah berikutnya