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 ke 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.list
di bucket sumber. Izin ini disertakan dalam peran Storage Object Viewer (roles/storage.objectViewer
) yang diperlukan untuk semua transfer. Tidak diperlukan peran tambahan.
Jika tujuannya adalah bucket namespace hierarkis:
storage.folders.create
di bucket tujuan. Izin ini disertakan dalam peran Storage Object User (roles/storage.objectUser
). Berikan peran ini selain peran yang tercantum dalam Izin transfer tanpa agen.
Untuk petunjuk tentang cara menambahkan peran ke agen layanan, lihat:
Perilaku transfer
Saat mentransfer antar-bucket namespace hierarkis:
- Objek dan metadata objek ditransfer.
- Folder dan metadata folder akan 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,
object1
difolderA
ditransfer 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
, Layanan Transfer Penyimpanan akan membuat folder baru bernamafolderA
dan mentransferobject1
ke folder tersebut. - Penghapusan folder di sink tidak didukung.