Folder terkelola Cloud Storage menyediakan kontrol akses terperinci ke objek di bucket Cloud Storage. Izin dapat ditetapkan di tingkat folder dalam bucket yang menggunakan akses level bucket yang seragam. Saat mentransfer objek antar-bucket Cloud Storage dengan Storage Transfer Service, izin folder terkelola ini dapat dipertahankan.
Batasan
Batasan berikut berlaku untuk transfer folder terkelola:
- Bucket sumber dan tujuan harus menggunakan akses level bucket yang seragam.
- Transfer folder terkelola tidak mendukung opsi
deleteObjectsUniqueInSinkataudeleteObjectsFromSourceAfterTransfer. - Tidak boleh ada IAM Conditions pada bucket tujuan atau project-nya yang menggunakan jenis resource bucket (
storage.googleapis.com/Bucket) atau jenis resource objek (storage.googleapis.com/Object). Jika ada bucket dalam project yang memiliki IAM Condition yang menggunakan salah satu jenis resource ini, folder terkelola tidak dapat ditransfer ke bucket mana pun dalam project tersebut, meskipun kondisi tersebut nantinya dihapus. - Transfer berdasarkan peristiwa tidak didukung.
- Transfer manifes tidak didukung.
Izin IAM
Izin Google Cloud Identity and Access Management (IAM) berikut diperlukan oleh agen layanan Storage Transfer Service.
Untuk sumber dan tujuan, izin dapat ditetapkan di level bucket, atau dapat ditetapkan di folder terkelola. Untuk menetapkan izin pada folder terkelola tujuan, folder tersebut harus sudah ada.
Sebaiknya jangan tetapkan izin folder terkelola di level project; lihat Pertimbangan keamanan untuk mengetahui info tambahan.
Di bucket sumber atau folder terkelola:
storage.managedFolders.getIamPolicystorage.managedFolders.liststorage.managedFolders.get
Di bucket atau folder terkelola tujuan:
storage.managedFolders.setIamPolicystorage.managedFolders.liststorage.managedFolders.create
Izin ini merupakan tambahan dari izin standar yang diperlukan oleh Storage Transfer Service:
Untuk memberikan izin folder terkelola yang diperlukan, buat peran khusus hanya dengan izin yang diperlukan.
Membuat transfer folder terkelola
Untuk membuat transfer yang berisi folder terkelola, tentukan
managedFolderTransferEnabled: true di transferSpec Anda. Jika ingin, Anda dapat menentukan nilai path untuk mentransfer folder terkelola tertentu saja.
POST https://storagetransfer./v1/transferJobs { "name": "transferJobs/NAME", "projectId": "PROJECT_ID", "transferSpec": { "gcsDataSource": { "bucketName": "SOURCE_BUCKET", "path": "SOURCE_PATH", "managedFolderTransferEnabled": true }, "gcsDataSink": { "bucketName": "DESTINATION_BUCKET", "path": "DESTINATION_PATH" } }, "status": "ENABLED" }
Jika izin transfer terkelola yang benar tidak ditetapkan di sumber dan tujuan, transfer akan gagal.
Lihat Membuat transfer untuk mengetahui detail tentang cara membuat transfer menggunakan REST API, atau lihat referensi transferJobs.create.
Pertimbangan keamanan
Memberikan izin folder terkelola kepada agen layanan memungkinkan akun mengubah kebijakan IAM pada folder tujuan, atau pada semua folder jika peran diberikan di level project. Hal ini menimbulkan risiko keamanan: pengguna dengan izin edit tugas dapat mengeksploitasi hal ini untuk memberikan hak istimewa kepada pihak berniat jahat. Untuk mengurangi risiko ini, pertimbangkan untuk mengisolasi transfer folder terkelola dalam project Google Cloud khusus.
Cloud Logging
Tindakan folder terkelola dicatat oleh Cloud Logging. Lihat Cloud Logging untuk Storage Transfer Service untuk mengetahui detailnya.
Pemecahan masalah
Untuk mendapatkan bantuan dalam membuat dan mengelola folder terkelola, lihat halaman Pemecahan masalah.