Halaman ini menunjukkan cara menyalin, mengganti nama, dan memindahkan objek di dalam dan di antara bucket di Cloud Storage.
Perlu diperhatikan bahwa meskipun beberapa alat di Cloud Storage membuat pemindahan objek atau penggantian nama tampak sebagai operasi unik, alat tersebut selalu merupakan operasi penyalinan yang diikuti dengan operasi penghapusan objek asli, karena objektidak dapat diubah.
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.
Library klien
Untuk menyelesaikan panduan ini menggunakan library klien Cloud Storage, 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.
Kecuali jika dinyatakan lain, permintaan library klien dibuat melalui JSON API dan memerlukan izin seperti yang tercantum dalam izin IAM untuk metode JSON. Untuk melihat metode JSON API mana yang dipanggil saat Anda membuat permintaan menggunakan library klien, buat log permintaan mentah.
Untuk daftar peran IAM 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.
Salin objek
Untuk menyalin objek di salah satu bucket Cloud Storage Anda:
Konsol
- Di Konsol Google Cloud, buka halaman Bucket Cloud Storage.
Pada daftar bucket, klik nama bucket yang berisi objek yang ingin disalin.
Halaman Detail bucket akan terbuka, dan tab Objek akan dipilih.
Buka objek, yang mungkin terletak dalam folder.
Klik menu Object overflow (more_vert) yang terkait dengan objek tersebut.
Klik Salin.
Panel Salin objek akan muncul.
Di kolom Destination, ketik nama bucket tujuan dan nama untuk objek yang disalin.
Atau, Anda dapat mengklik Jelajahi untuk memilih tujuan, tetapi opsi penjelajahan dibatasi untuk bucket dalam project saat ini.
Klik Salin.
Untuk mempelajari cara mendapatkan informasi error mendetail tentang operasi Cloud Storage yang gagal di konsol Google Cloud, lihat Pemecahan masalah.
Command line
Gunakan perintah gcloud storage cp
:
gcloud storage cp gs://SOURCE_BUCKET_NAME/SOURCE_OBJECT_NAME gs://DESTINATION_BUCKET_NAME/NAME_OF_COPY
Dengan keterangan:
SOURCE_BUCKET_NAME
adalah nama bucket yang berisi objek yang ingin Anda salin. Contoh,my-bucket
.SOURCE_OBJECT_NAME
adalah nama objek yang ingin Anda salin. Contoh,pets/dog.png
.DESTINATION_BUCKET_NAME
adalah nama bucket tempat Anda ingin menyalin objek. Contoh,another-bucket
.NAME_OF_COPY
adalah nama yang ingin Anda berikan untuk salinan objek. Contoh,shiba.png
.
Jika berhasil, responsnya akan terlihat mirip dengan contoh berikut:
Copying gs://example-bucket/file.txt to gs://other-bucket/file-copy.txt Completed files 1/1 | 164.3kiB/164.3kiB
Library klien
C++
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage C++ API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
C#
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage C# API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Go
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Go API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Java
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Java API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Node.js
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Node.js API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
PHP
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage PHP API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Python
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Python API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Ruby
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Ruby API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
REST API
JSON API
Telah menginstal dan melakukan inisialisasigcloud CLI, agar dapat membuat token akses untuk header
Authorization
.Atau, Anda dapat membuat token akses menggunakan OAuth 2.0 Playground dan menyertakannya di header
Authorization
.Gunakan
cURL
untuk memanggil JSON API dengan permintaanPOST
Object:curl -X POST \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Length: 0" \ "https://storage.googleapis.com/storage/v1/b/SOURCE_BUCKET_NAME/o/SOURCE_OBJECT_NAME/rewriteTo/b/DESTINATION_BUCKET_NAME/o/NAME_OF_COPY"
Dengan keterangan:
SOURCE_BUCKET_NAME
adalah nama bucket yang berisi objek yang ingin Anda salin. Contoh,my-bucket
.SOURCE_OBJECT_NAME
adalah nama objek yang berenkode URL yang ingin Anda salin. Misalnya,pets/dog.png
, dienkode URL sebagaipets%2Fdog.png
.DESTINATION_BUCKET_NAME
adalah nama bucket tempat Anda ingin menyalin objek. Contoh,another-bucket
.NAME_OF_COPY
adalah nama berenkode URL yang ingin Anda berikan salinan objek. Contoh,shiba.png
.
Karena metode
rewrite
menyalin data dalam bagian berukuran terbatas, salinan Anda mungkin memerlukan beberapa permintaan, terutama untuk objek besar.Misalnya, respons berikut terhadap permintaan
rewrite
menunjukkan bahwa Anda perlu membuat permintaanrewrite
tambahan:{ "kind": "storage#rewriteResponse", "totalBytesRewritten": 1048576, "objectSize": 10000000000, "done": false, "rewriteToken": TOKEN_VALUE }
Gunakan
rewriteToken
dalam permintaan berikutnya untuk melanjutkan penyalinan data:curl -X POST \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Length: 0" \ -d '{"rewriteToken": "TOKEN_VALUE"}' \ "https://storage.googleapis.com/storage/v1/b/SOURCE_BUCKET_NAME/o/SOURCE_OBJECT_NAME/rewriteTo/b/DESTINATION_BUCKET_NAME/o/NAME_OF_COPY"
Dengan keterangan:
TOKEN_VALUE
adalah nilairewriteToken
yang ditampilkan dalam permintaan sebelumnya.- Semua nilai lainnya cocok dengan yang digunakan dalam permintaan sebelumnya.
Saat objek disalin sepenuhnya, respons terakhir memiliki properti
done
yang disetel ketrue
, tidak ada propertirewriteToken
, dan metadata salinan disertakan dalam propertiresource
.{ "kind": "storage#rewriteResponse", "totalBytesRewritten": 10000000000, "objectSize": 10000000000, "done": true, "resource": objects Resource }
XML API
Telah menginstal dan melakukan inisialisasigcloud CLI, agar dapat membuat token akses untuk header
Authorization
.Atau, Anda dapat membuat token akses menggunakan OAuth 2.0 Playground dan menyertakannya di header
Authorization
.Gunakan
cURL
untuk memanggil XML API dengan permintaanPUT
Object:curl -X PUT \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "x-goog-copy-source: SOURCE_BUCKET_NAME/SOURCE_OBJECT_NAME" \ "https://storage.googleapis.com/DESTINATION_BUCKET_NAME/NAME_OF_COPY"
Dengan keterangan:
SOURCE_BUCKET_NAME
adalah nama bucket yang berisi objek yang ingin Anda salin. Contoh,my-bucket
.SOURCE_OBJECT_NAME
adalah nama objek yang ingin Anda salin. Contoh,pets/dog.png
.DESTINATION_BUCKET_NAME
adalah nama bucket tempat Anda ingin menyalin objek. Contoh,another-bucket
.NAME_OF_COPY
adalah nama berenkode URL yang ingin Anda berikan salinan objek. Contoh,shiba.png
.
Memindahkan atau mengganti nama objek
Untuk memindahkan objek di Cloud Storage antar bucket, atau mengganti nama objek di dalam bucket:
Konsol
- Di Konsol Google Cloud, buka halaman Bucket Cloud Storage.
Dalam daftar bucket, klik nama bucket yang berisi objek yang ingin dipindahkan atau diganti namanya.
Halaman Detail bucket akan terbuka, dan tab Objek akan dipilih.
Buka objek, yang mungkin terletak dalam folder.
Klik menu Object overflow (more_vert) yang terkait dengan objek tersebut.
Jika ingin memberi nama baru untuk objek di bucket yang sama, klik Ganti nama.
Di jendela overlay yang muncul, masukkan nama baru untuk objek.
Klik Ganti nama.
Jika Anda ingin memindahkan objek ke bucket lain, klik Pindahkan.
Di jendela overlay yang muncul, klik Jelajahi.
Pilih tujuan untuk objek yang Anda pindahkan.
Klik Select.
Klik Pindahkan.
Untuk mempelajari cara mendapatkan informasi error mendetail tentang operasi Cloud Storage yang gagal di Konsol Google Cloud, lihat Pemecahan masalah.
Command line
Gunakan perintah gcloud storage mv
:
gcloud storage mv gs://SOURCE_BUCKET_NAME/SOURCE_OBJECT_NAME gs://DESTINATION_BUCKET_NAME/DESTINATION_OBJECT_NAME
Dengan keterangan:
SOURCE_BUCKET_NAME
adalah nama bucket yang berisi objek yang ingin dipindahkan atau diganti namanya. Contoh,my-bucket
.SOURCE_OBJECT_NAME
adalah nama objek yang ingin Anda pindahkan atau ganti namanya. Contoh,pets/dog.png
.DESTINATION_BUCKET_NAME
adalah nama bucket yang menyimpan objek yang dipindahkan atau diganti namanya. Contoh,another-bucket
.DESTINATION_OBJECT_NAME
adalah nama yang Anda inginkan untuk objek setelah pemindahan atau penggantian nama. Contoh,shiba.png
.
Jika berhasil, responsnya akan terlihat mirip dengan contoh berikut:
Copying gs://example-bucket/old-file.txt to gs://new-bucket/new-file.txt Removing gs://example-bucket/old-file.txt... Completed files 1/1 | 164.3kiB/164.3kiB
Library klien
C++
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage C++ API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
C#
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage C# API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Go
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Go API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Java
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Java API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Node.js
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Node.js API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
PHP
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage PHP API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Python
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Python API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Ruby
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Ruby API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
REST API
JSON API
Untuk memindahkan atau mengganti nama objek menggunakan JSON API secara langsung, pertama-tama buat salinan objek yang memiliki properti yang Anda inginkan, lalu hapus objek asli.
XML API
Untuk memindahkan atau mengganti nama objek menggunakan XML API secara langsung, pertama-tama buat salinan objek yang memiliki properti yang Anda inginkan, lalu hapus objek asli.
Sebaiknya gunakan Storage Transfer Service untuk memindahkan data berukuran lebih dari 1 TB antar bucket.
Langkah selanjutnya
- Mengubah kelas penyimpanan objek.
- Mengedit metadata objek.
- Membuat objek dan bucket dapat diakses secara publik.
- Pelajari lebih lanjut persyaratan penamaan objek.
- Pelajari cara menggunakan prasyarat permintaan untuk mencegah kondisi race.