Namespace hierarkis Cloud Storage menyimpan data dalam struktur sistem file logis, menggunakan folder untuk mengatur objek. Untuk mengetahui detailnya, lihat Namespace hierarkis.
Storage Transfer Service dapat mentransfer ke dan dari bucket Cloud Storage yang menggunakan namespace hierarkis. Agar berhasil mentransfer folder dan metadata folder, izin tambahan harus diberikan kepada agen layanan Storage Transfer Service.
Izin yang diperlukan
Selain izin standar yang diperlukan untuk transfer, agen layanan Storage Transfer Service harus diberi izin IAM berikut.
Jika sumbernya adalah bucket namespace hierarkis:
storage.folders.listdi bucket sumber. Izin ini disertakan dalam peran Storage Object Viewer (roles/storage.objectViewer) yang diperlukan untuk semua transfer. Tidak ada peran tambahan yang diperlukan.
Jika tujuannya adalah bucket namespace hierarkis:
storage.folders.createpada bucket tujuan. Izin ini disertakan dalam peran Storage Object User (roles/storage.objectUser). Berikan peran ini selain peran yang tercantum di Izin transfer tanpa agen.
Untuk mengetahui petunjuk tentang cara menambahkan peran ke agen layanan, lihat:
Perilaku transfer
Saat mentransfer antar dua bucket namespace hierarkis:
- Objek dan metadata objek ditransfer.
- Folder dan metadata folder akan ditransfer.
- Penghapusan folder di sumber atau tujuan tidak didukung.
Saat mentransfer dari bucket namespace hierarkis ke bucket namespace datar:
- Objek dan metadata objek ditransfer.
- Folder ditransfer sebagai awalan objek. Misalnya,
object1difolderAditransfer ke tujuan sebagaifolderA/object1. - Metadata folder tidak ditransfer.
- Penghapusan folder di sumber tidak didukung.
Saat mentransfer dari bucket namespace datar ke bucket namespace hierarkis:
- Objek dan metadata objek ditransfer.
- Awalan objek digunakan untuk membuat folder yang belum ada. Misalnya, saat
mentransfer
folderA/object1, Storage Transfer Service akan membuat folder baru bernamafolderAdan mentransferobject1ke folder tersebut. - Penghapusan folder di tujuan sinkronisasi tidak didukung.