Memindahkan dan mengganti nama bucket

Saat membuat bucket, beberapa properti yang Anda tetapkan bersifat permanen dan tidak dapat diubah, termasuk nama bucket, lokasi geografis, dan project tempatnya berada. Namun, Anda dapat secara efektif memindahkan atau mengganti nama bucket:

  • Jika tidak ada data di bucket lama, hapus bucket dan buat bucket lain dengan properti yang Anda inginkan

  • Jika Anda memiliki data di bucket lama, buat bucket baru dengan properti yang Anda inginkan, salin data dari bucket lama ke bucket baru, lalu hapus bucket lama beserta isinya. Langkah-langkah di halaman ini menjelaskan proses ini.

    • Jika ingin bucket baru memiliki nama yang sama dengan bucket lama, Anda harus memindahkan data ke bucket dengan nama yang berbeda untuk sementara. Langkah ini memungkinkan Anda menghapus bucket asli sehingga Anda dapat menggunakan kembali nama bucket.

    • Pemindahan data antar lokasi akan menimbulkan biaya penggunaan jaringan. Selain itu, pemindahan data mungkin dikenai biaya tambahan, bergantung pada class penyimpanan data sumber dan lokasi bucket tujuan. Untuk mengetahui informasi selengkapnya, lihat Harga Cloud Storage.

Izin yang diperlukan

Konsol

Untuk menyelesaikan panduan ini menggunakan konsol Google Cloud, Anda harus memiliki izin IAM yang tepat. Jika bucket yang ingin Anda akses ada di project yang tidak Anda buat, pemilik project harus memberi Anda peran yang berisi izin yang diperlukan.

Untuk mengetahui daftar izin yang diperlukan untuk tindakan tertentu, lihat Izin IAM untuk konsol Google Cloud.

Untuk daftar peran yang relevan, lihat peran Cloud Storage. Atau, Anda dapat membuat peran khusus yang memiliki izin tertentu dan terbatas.

Command line

Untuk menyelesaikan panduan ini menggunakan utilitas command line, Anda harus memiliki izin IAM yang sesuai. Jika bucket yang ingin Anda akses ada di project yang tidak Anda buat, pemilik project harus memberi Anda peran yang berisi izin yang diperlukan.

Guna mengetahui daftar izin yang diperlukan untuk tindakan tertentu, lihat Izin IAM untuk perintah gcloud storage.

Untuk daftar peran yang relevan, lihat peran Cloud Storage. Atau, Anda dapat membuat peran khusus yang memiliki izin tertentu dan terbatas.

REST API

JSON API

Untuk menyelesaikan panduan ini menggunakan JSON API, Anda harus memiliki izin IAM yang sesuai. Jika bucket yang ingin Anda akses ada di project yang tidak Anda buat, pemilik project harus memberi Anda peran yang berisi izin yang diperlukan.

Untuk mengetahui daftar izin yang diperlukan untuk tindakan tertentu, lihat izin IAM untuk metode JSON.

Untuk daftar peran yang relevan, lihat peran Cloud Storage. Atau, Anda dapat membuat peran khusus yang memiliki izin tertentu dan terbatas.

Memindahkan data dari satu bucket ke bucket lain

Konsol

Gunakan Storage Transfer Service dari dalam konsol Google Cloud:

  1. Jika Anda belum memiliki bucket tujuan, buat bucket.

  2. Buka halaman Transfer di konsol Google Cloud.

    Buka halaman Transfer

  3. Klik Buat tugas transfer.

  4. Ikuti panduan langkah demi langkah, dengan mengklik Langkah berikutnya saat Anda menyelesaikan setiap langkah:

    • Pilih sumber: Gunakan bucket Google Cloud Storage sebagai jenis sumber, lalu masukkan nama bucket yang diinginkan secara langsung, atau klik Jelajahi untuk menemukan lalu pilih bucket yang Anda inginkan.

    • Pilih tujuan: Masukkan nama bucket yang diinginkan secara langsung, atau klik Jelajahi untuk menemukan dan memilih bucket yang Anda inginkan.

    • Pilih setelan: Pilih opsi Hapus file dari sumber setelah file ditransfer.

    • Opsi penjadwalan: Anda dapat mengabaikan bagian ini.

  5. Setelah menyelesaikan panduan langkah demi langkah, klik Buat.

    Tindakan ini akan memulai proses penyalinan objek dari bucket lama ke bucket baru. Proses ini mungkin memakan waktu. Namun, setelah mengklik Buat, Anda dapat keluar dari konsol Google Cloud.

    Untuk melihat progres transfer:

    Buka halaman Transfer di konsol Google Cloud.

    Buka halaman Transfer

    Untuk mempelajari cara mendapatkan informasi error mendetail tentang operasi Cloud Storage yang gagal di konsol Google Cloud, lihat Pemecahan masalah.

  6. Setelah transfer selesai, Anda tidak perlu melakukan apa pun untuk menghapus objek dari bucket lama jika telah mencentang kotak Hapus objek sumber setelah transfer selesai selama penyiapan. Namun, Anda mungkin juga ingin menghapus bucket lama, yang harus dilakukan secara terpisah.

Command line

  1. Jika Anda belum memilikinya, buat bucket tujuan.

  2. Untuk menyalin konten bucket sumber secara berulang ke bucket tujuan, gunakan perintah gcloud storage cp dengan opsi --recursive:

    gcloud storage cp --recursive gs://SOURCE_BUCKET/* gs://DESTINATION_BUCKET

    Dengan keterangan:

    • SOURCE_BUCKET adalah nama bucket asli Anda. Contoh, old-bucket.

    • DESTINATION_BUCKET adalah nama bucket tempat Anda memindahkan data. Contoh, my-bucket.

    Jika bucket Anda menggunakan folder terkelola dan namespace datar, Anda harus menyertakan flag --include-managed-folders dalam perintah agar folder terkelola dapat disalin.

  3. Untuk menghapus konten dari bucket sumber secara berulang, beserta bucket sumber itu sendiri, gunakan perintah gcloud storage rm dengan opsi --recursive:

    gcloud storage rm --recursive gs://SOURCE_BUCKET

    Dengan SOURCE_BUCKET adalah nama bucket asli Anda. Contoh, old-bucket.

    Atau, untuk menghapus konten dari bucket sumber tanpa menghapus bucket sumber itu sendiri, gunakan perintah gcloud storage rm dengan flag --all-versions dan karakter pengganti **:

    gcloud storage rm --all-versions gs://SOURCE_BUCKET/**

    Dengan SOURCE_BUCKET adalah nama bucket asli Anda. Contoh, old-bucket.

REST API

JSON API

  1. Jika Anda belum memiliki bucket tujuan, buat bucket.

  2. Salin setiap objek dari bucket sumber ke bucket tujuan.

  3. Hapus setiap objek di bucket sumber Anda.

  4. Hapus bucket sumber Anda.

XML API

  1. Jika Anda belum memiliki bucket tujuan, buat bucket.

  2. Salin setiap objek dari bucket sumber ke bucket tujuan.

  3. Hapus setiap objek di bucket sumber Anda.

  4. Hapus bucket sumber Anda.

Langkah berikutnya