Upload dan download

Halaman ini membahas konsep yang terkait dengan mengupload dan mendownload objek. Anda dapat mengupload dan menyimpan jenis data MIME apa pun hingga berukuran 5 TiB.

Upload

Anda dapat mengirim permintaan upload ke Cloud Storage dengan cara berikut:

  • Upload permintaan tunggal. Metode upload dengan objek diupload sebagai satu permintaan. Gunakan metode ini jika file berukuran kecil untuk diupload secara keseluruhan jika koneksi gagal. Lihat Mengupload objek dari file atau Mengupload objek dari memori untuk mendapatkan panduan tentang upload permintaan tunggal.

  • Upload yang dapat dilanjutkan. Metode upload untuk transfer yang lebih andal, yang sangat penting untuk file besar. Upload yang dapat dilanjutkan adalah pilihan yang tepat untuk sebagian besar aplikasi, karena juga dapat digunakan untuk file kecil, dan hanya membutuhkan satu permintaan HTTP tambahan per upload. Anda juga dapat menggunakan upload yang dapat dilanjutkan untuk melakukan transfer streaming, sehingga Anda dapat mengupload objek dengan ukuran yang tidak diketahui.

  • Upload multibagian XML API. Metode upload yang kompatibel dengan upload multibagian Amazon S3. File diupload sebagian dan digabungkan menjadi satu objek dengan permintaan akhir. Dengan upload multibagian XML API, Anda dapat mengupload bagian-bagian secara paralel, sehingga berpotensi mengurangi waktu untuk menyelesaikan upload secara keseluruhan.

Dengan menggunakan jenis upload dasar berikut, strategi upload lebih lanjut dapat diterapkan:

  • Upload gabungan paralel. Strategi upload, di mana Anda memotong file dan mengupload bagian secara paralel. Tidak seperti upload multibagian XML API, upload komposit paralel menggunakan operasi compose, dan objek akhir disimpan sebagai objek gabungan.

  • Upload streaming. Metode upload yang memungkinkan Anda mengupload data tanpa harus menyimpan data terlebih dahulu ke file, yang berguna jika Anda tidak mengetahui ukuran total upload di awal upload.

  • Upload encoding transfer dengan potongan. Upload satu permintaan yang menyertakan header Transfer-Encoding: chunked, sehingga upload dapat dikirim dalam beberapa bagian data berurutan.

Pertimbangan ukuran upload

Saat memilih apakah akan menggunakan upload permintaan tunggal, bukan upload yang dapat dilanjutkan atau upload multibagian XML API, pertimbangkan jumlah waktu yang akan hilang jika terjadi kegagalan jaringan dan Anda harus memulai ulang upload dari awal. Untuk koneksi yang lebih cepat, ukuran batas Anda biasanya bisa lebih besar.

Misalnya, Anda bersedia menoleransi waktu yang hilang selama 30 detik:

  • Jika mengupload dari sistem lokal dengan kecepatan upload rata-rata 8 Mbps, Anda dapat menggunakan upload permintaan tunggal untuk file sebesar 30 MB.

  • Jika Anda mengupload dari layanan dalam region yang memiliki kecepatan upload rata-rata 500 Mbps, ukuran batas untuk file bisa berukuran hingga 2 GB.

Download

Semua download dari Cloud Storage memiliki perilaku dasar yang sama: permintaan GET HTTP atau HTTPS yang dapat menyertakan header Range opsional, yang menentukan bagian tertentu dari objek yang akan didownload.

Dengan perilaku download dasar ini, Anda dapat melanjutkan download yang terhenti, dan dapat menggunakan strategi download lanjutan, seperti download objek irisan dan download streaming.

Dukungan per alat

Konsol

Anda dapat melakukan jenis upload dan download berikut ini saat menggunakan konsol Google Cloud:

Command line

Anda dapat melakukan jenis upload dan download berikut ini saat menggunakan Google Cloud CLI:

Library klien

C++

Anda dapat melakukan jenis upload dan download berikut ini saat menggunakan library klien C++:

C#

Anda dapat melakukan jenis upload dan download berikut ini saat menggunakan library klien C#:

Go

Anda dapat melakukan jenis upload dan download berikut ini saat menggunakan library klien Go:

Java

Anda dapat melakukan jenis upload dan download berikut ini saat menggunakan library klien Java:

Node.js

Anda dapat melakukan jenis upload dan download berikut ini saat menggunakan library klien Node.js:

PHP

Anda dapat melakukan jenis upload dan download berikut ini saat menggunakan library klien PHP:

Python

Anda dapat melakukan jenis upload dan download berikut ini saat menggunakan library klien Python:

Ruby

Anda dapat melakukan jenis upload dan download berikut ini saat menggunakan library klien Ruby:

Terraform

Anda dapat melakukan upload permintaan tunggal saat menggunakan Terraform. Upload yang dapat dilanjutkan terjadi secara otomatis jika file yang diupload berukuran lebih besar dari 16 MiB.

REST API

JSON API

Anda dapat melakukan jenis upload dan download berikut ini saat menggunakan JSON API:

XML API

Anda dapat melakukan jenis upload dan download berikut ini saat menggunakan XML API:

Jika Anda menggunakan REST API untuk mengupload dan mendownload, lihat Meminta endpoint untuk mengetahui pembahasan lengkap terkait endpoint permintaan yang dapat Anda gunakan.

Langkah berikutnya