Izin pengguna yang diperlukan

Membuat, mengelola, atau memantau transfer dengan Storage Transfer Service memerlukan izin dan peran IAM untuk akun pengguna, alat otomatisasi, atau akun layanan Anda.

Izin ini berlaku untuk transfer tanpa agen dan berbasis agen. Untuk mengetahui informasi umum tentang cara memberikan peran IAM, lihat Memberikan, mengubah, dan mencabut akses ke resource.

Izin Storage Transfer Service yang diperlukan

Untuk berinteraksi dengan Storage Transfer Service, Anda harus memberikan salah satu peran yang telah ditetapkan berikut atau izin khusus yang setara kepada akun pengguna, grup, atau akun layanan Anda di project Google Cloud yang membuat transfer:

Peran Kemampuan utama
Storage Transfer Admin
(roles/storagetransfer.admin) 		Kontrol penuh atas resource Storage Transfer Service:
  • Membuat, menjalankan, mengedit, dan menghapus tugas transfer.
  • Membuat, mengonfigurasi, dan menghapus kumpulan agen transfer.
  • Mengonfigurasi batas bandwidth lingkup project.
  • Melihat semua operasi, status, dan log transfer.
Storage Transfer User
(roles/storagetransfer.user) 		Membuat, memperbarui, dan menjalankan tugas transfer dan kumpulan agen tanpa izin penghapusan:
  • Membuat, mendapatkan, memperbarui, dan mencantumkan tugas transfer.
  • Membuat, mendapatkan, memperbarui, dan mencantumkan kumpulan agen.
  • Mengonfigurasi batas bandwidth lingkup project.
  • Menjalankan, menjeda, dan melanjutkan operasi transfer.
  • Tidak dapat menghapus tugas transfer atau kumpulan agen.
Storage Transfer Viewer
(roles/storagetransfer.viewer) 		Akses hanya baca untuk memeriksa tugas transfer, operasi, dan kumpulan agen. Direkomendasikan untuk pemantauan dan audit.

Untuk mengetahui daftar mendetail masing-masing izin dalam setiap peran, lihat Referensi peran dan izin. Jika Anda mengonfigurasi tugas transfer untuk mendelegasikan izin ke akun layanan yang dikelola pengguna, akun pengguna Anda juga harus memiliki peran Service Account User (roles/iam.serviceAccountUser) di akun layanan tersebut; lihat Mendelegasikan izin agen layanan ke akun layanan yang dikelola pengguna.

Memberikan peran Storage Transfer Service di project Anda

Konsol

  1. Di konsol Google Cloud , buka halaman IAM.

    Buka IAM

  2. Pastikan project transfer Anda dipilih, lalu klik Grant access.

  3. Di kolom New principals, masukkan email akun pengguna atau akun layanan Anda.

  4. Di menu drop-down Select a role, telusuri dan pilih Storage Transfer Admin, Storage Transfer User, atau Storage Transfer Viewer.

  5. Opsional: Untuk mengizinkan konsol Google Cloud memeriksa izin agen layanan yang tidak ada dan meminta Anda untuk memberikannya secara otomatis selama pembuatan transfer:

    1. Klik + Add another role.
    2. Telusuri dan pilih Role Viewer (roles/iam.roleViewer), yang memberikan resourcemanager.projects.getIamPolicy.

  6. Klik Simpan.

gcloud

  1. Berikan peran Storage Transfer Service:

    gcloud projects add-iam-policy-binding PROJECT_ID \
   --member="PRINCIPAL" \
   --role="roles/storagetransfer.ROLE"

    Ganti:

    • PROJECT_ID: Project tempat Anda akan menjalankan transfer.
    • PRINCIPAL: Akun Anda diformat sebagai user:EMAIL untuk akun pengguna, atau serviceAccount:SA_EMAIL untuk akun layanan.
    • ROLE: Salah satu dari admin, user, atau viewer.

  2. Opsional: Untuk mengizinkan konsol Google Cloud memeriksa izin agen layanan yang tidak ada dan meminta Anda untuk memberikannya secara otomatis selama pembuatan transfer, berikan peran Role Viewer:

    gcloud projects add-iam-policy-binding PROJECT_ID \
   --member="PRINCIPAL" \
   --role="roles/iam.roleViewer"

Izin Cloud Storage yang diperlukan

Untuk mengonfigurasi transfer yang menggunakan bucket Cloud Storage sebagai sumber, sink, atau lokasi staging perantara, akun Anda harus memiliki izin untuk melihat dan mengubah kebijakan IAM bucket agar Anda dapat memberikan peran yang diperlukan ke akun agen layanan atau agen transfer Storage Transfer Service.

Akun Anda memerlukan:

  • storage.buckets.getIamPolicy
  • storage.buckets.setIamPolicy

Salah satu peran bawaan berikut memberikan izin ini:

  • Storage Admin (roles/storage.admin)
  • Storage Legacy Bucket Owner (roles/storage.legacyBucketOwner)

Memberikan peran Cloud Storage pada bucket

Konsol

  1. Di konsol Google Cloud , buka halaman Buckets Cloud Storage.

    Buka Buckets

  2. Klik menu Bucket overflow () untuk bucket, lalu pilih Edit access.
  3. Klik + Add principal.
  4. Di kolom New principals, masukkan email akun pengguna atau akun layanan Anda.
  5. Di menu drop-down Select a role, telusuri dan pilih Storage Admin.
  6. Klik Simpan.

gcloud

Jalankan gcloud storage buckets add-iam-policy-binding:

gcloud storage buckets add-iam-policy-binding gs://BUCKET_NAME \
    --member="PRINCIPAL" \
    --role="roles/storage.admin"

Ganti:

  • BUCKET_NAME: Nama bucket sumber, sink, atau perantara Anda.
  • PRINCIPAL: Akun Anda diformat sebagai user:EMAIL untuk akun pengguna, atau serviceAccount:SA_EMAIL untuk akun layanan.

Langkah berikutnya

Langkah berikutnya bergantung pada apakah transfer Anda memerlukan agen transfer: