Mentransfer folder terkelola Cloud Storage

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 deleteObjectsUniqueInSink atau deleteObjectsFromSourceAfterTransfer.
  • 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.getIamPolicy
  • storage.managedFolders.list
  • storage.managedFolders.get

Di bucket atau folder terkelola tujuan:

  • storage.managedFolders.setIamPolicy
  • storage.managedFolders.list
  • storage.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.