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.listpada bucket sumber. Izin ini disertakan dalam peran Storage Object Viewer (roles/storage.objectViewer) yang diperlukan di bucket sumber. Tidak diperlukan peran tambahan.
Jika tujuannya adalah bucket namespace hierarkis:
storage.folders.createpada bucket tujuan. Izin ini disertakan dalam peran Storage Object User (roles/storage.objectUser) yang diperlukan di bucket tujuan. Tidak diperlukan peran tambahan.
Untuk mengetahui petunjuk tentang cara menambahkan peran ke agen layanan, lihat:
Perilaku transfer
Saat mentransfer antara dua bucket namespace hierarkis:
- Objek dan metadata objek ditransfer.
- Folder dan metadata folder ditransfer.
- Penghapusan folder di sumber atau sink 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 tidak ada. Misalnya, saat mentransfer
folderA/object1, Storage Transfer Service akan membuat folder baru bernamafolderAdan mentransferobject1ke folder tersebut. - Penghapusan folder di sink tidak didukung.