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, lalu 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, dan hapus bucket lama beserta isinya. Langkah-langkah di halaman ini menjelaskan proses tersebut.
- Jika ingin bucket baru memiliki nama yang sama dengan bucket lama, Anda harus memindahkan data ke bucket dengan nama yang berbeda untuk sementara. Tindakan 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 dapat menimbulkan biaya tambahan, bergantung pada kelas 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.

Untuk 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 Cloud Storage Transfer Service dari dalam konsol Google Cloud:

Jika Anda belum memiliki bucket tujuan, buat bucket.
Buka halaman Transfer di konsol Google Cloud.

Buka halaman Transfer
Klik Buat tugas transfer.
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.
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.
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

Jika Anda belum memilikinya, buat bucket tujuan.
Untuk menyalin konten bucket sumber ke bucket tujuan, gunakan salah satu metode berikut:
- Untuk menyalin semua objek Anda secara rekursif dari bucket sumber 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.
- Untuk menyalin semua objek dan folder terkelola secara berulang dari bucket sumber ke bucket tujuan, gunakan perintah gcloud alpha storage cp dengan opsi --include-managed-folders dan --recursive:
```
gcloud alpha storage cp --include-managed-folders --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.
Untuk menghapus bucket sumber, gunakan salah satu metode berikut:
- Untuk menghapus semua objek secara berulang dari bucket sumber, 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.
- Untuk menghapus semua objek dan folder terkelola secara rekursif dari bucket sumber, bersama dengan bucket sumber itu sendiri, gunakan perintah gcloud alpha storage rm dengan opsi --recursive:
```
gcloud alpha storage rm --recursive gs://SOURCE_BUCKET
```
  Dengan SOURCE_BUCKET adalah nama bucket asli Anda. Contoh, old-bucket.
- Untuk menghapus objek dan folder terkelola dari bucket sumber tanpa menghapus bucket sumber itu sendiri, gunakan perintah gcloud alpha storage rm tanpa flag --recursive:
```
gcloud alpha storage rm --all-versions gs://SOURCE_BUCKET/**
```
  Dengan SOURCE_BUCKET adalah nama bucket asli Anda. Contoh, old-bucket.

REST API

JSON API

Jika Anda belum memiliki bucket tujuan, buat bucket.
Salin setiap objek dari bucket sumber ke bucket tujuan.
Hapus setiap objek di bucket sumber.
Hapus bucket sumber.

XML API

Jika Anda belum memiliki bucket tujuan, buat bucket.
Salin setiap objek dari bucket sumber ke bucket tujuan.
Hapus setiap objek di bucket sumber.
Hapus bucket sumber.

Langkah selanjutnya

Menyalin, mengganti nama, atau memindahkan setiap objek.
Pelajari lokasi bucket yang tersedia dan panduan penamaan bucket.
Pelajari lebih lanjut cara membuat dan mengelola transfer data dengan Konsol Google Cloud.
Pelajari alat Pemindah bucket, yang merupakan alat tidak resmi untuk memudahkan pemindahan bucket.