Mengupload dan mendownload objek penyimpanan

Halaman ini menunjukkan cara mengupload dan mendownload objek ke dan dari bucket penyimpanan perlengkapan air-gapped Google Distributed Cloud (GDC).

Sebelum memulai

Namespace project mengelola resource bucket di server Management API. Anda harus memiliki project untuk bekerja dengan bucket dan objek.

Anda juga harus memiliki izin bucket yang sesuai untuk melakukan operasi berikut. Lihat Memberikan akses bucket.

Panduan penamaan objek

Gunakan panduan berikut untuk memberi nama objek:

  • Gunakan karakter UTF-8 saat memberi nama objek.
  • Jangan menyertakan informasi identitas pribadi (PII).

Mengupload objek ke bucket penyimpanan

Untuk mengupload objek, jalankan perintah berikut:

gdcloud storage cp LOCAL_PATH s3://REMOTE_PATH
gdcloud storage cp s3://REMOTE_SOURCE_PATH s3://REMOTE_MOVE_DESTINATION_PATH
gdcloud storage mv s3://REMOTE_SOURCE_PATH s3://REMOTE_MOVE_DESTINATION_PATH

Perintah berikut mengupload semua file teks dari direktori lokal ke bucket:

gdcloud storage cp *.txt s3://BUCKET

Perintah berikut mengupload beberapa file dari direktori lokal ke bucket:

gdcloud storage cp abc1.txt abc2.txt s3://BUCKET

Untuk mengupload folder ke bucket, gunakan opsi --recursive untuk menyalin seluruh hierarki direktori. Perintah berikut mengupload hierarki direktori dir:

gdcloud storage cp dir s3://BUCKET --recursive

Lakukan upload multibagian untuk objek besar, atau gunakan upload multibagian secara otomatis saat Anda memiliki file yang akan diupload dengan ukuran lebih besar dari 15 MB. Dalam hal ini, file akan dibagi menjadi beberapa bagian, dengan setiap bagian berukuran 15 MB. Bagian terakhir lebih kecil. Setiap bagian diupload secara terpisah dan direkonstruksi di tujuan saat transfer selesai.

Jika upload salah satu bagian gagal, Anda dapat memulai ulang upload tanpa memengaruhi bagian lain yang sudah diupload.

Ada dua opsi terkait upload multipart:

  • --disable-multipart: menonaktifkan upload multipart untuk semua file.
  • --multipart-chunk-size-mb=SIZE: menetapkan ukuran setiap bagian dari upload multipart.

File yang lebih besar dari SIZE akan otomatis diupload sebagai multithreaded-multipart. File yang lebih kecil diupload menggunakan metode tradisional. SIZE dalam megabyte. Ukuran potongan default adalah 15 MB. Ukuran potongan minimum yang diizinkan adalah 5 MB, dan maksimum adalah 5 GB.

Mendownload objek dari bucket penyimpanan

Untuk mendapatkan objek dari bucket:

gdcloud storage cp s3://BUCKET/OBJECT LOCAL_FILE_TO_SAVE

Untuk mendownload semua file teks dari bucket ke direktori saat ini:

gdcloud storage cp s3://BUCKET/*.txt .

Untuk mendownload file teks abc.txt dari bucket ke direktori Anda saat ini:

gdcloud storage cp s3://BUCKET/abc.txt .

Untuk mendownload file versi lama, tampilkan semua versi file terlebih dahulu:

gdcloud storage ls s3://BUCKET/abc.txt --all-versions

Contoh output:

s3://my-bucket/abc.txt#OEQxNTk4MUEtMzEzRS0xMUVFLTk2N0UtQkM4MjAwQkJENjND
s3://my-bucket/abc.txt#ODgzNEYzQ0MtMzEzRS0xMUVFLTk2NEItMjI1MTAwQkJENjND
s3://my-bucket/abc.txt#ODNCNDEzNzgtMzEzRS0xMUVFLTlDOUMtQzRDOTAwQjg3RTg3

Kemudian, download file teks abc.txt versi tertentu dari bucket ke direktori Anda saat ini:

gdcloud storage cp s3://BUCKET/abc.txt#OEQxNTk4MUEtMzEzRS0xMUVFLTk2N0UtQkM4MjAwQkJENjND .