Mengupload dan mendownload objek penyimpanan dalam project

Halaman ini menunjukkan cara mengupload dan mendownload objek ke dan dari bucket penyimpanan yang terisolasi dari internet Google Distributed Cloud (GDC).

Sebelum memulai

Namespace project mengelola resource bucket di server Management API. Anda harus memiliki project untuk menggunakan 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

Konsol

  1. Di menu navigasi, klik Object Storage.
  2. Klik nama bucket tempat Anda ingin mengupload objek.
  3. Opsional: Jika Anda ingin membuat folder untuk menyimpan objek, klik Buat folder > masukkan nama folder > klik Buat.
  4. Klik Upload file secara langsung, atau buka folder yang baru saja Anda buat, lalu klik Upload file.
  5. Pilih file yang diinginkan, lalu klik Buka.
  6. Tunggu pesan konfirmasi bahwa upload berhasil.

CLI

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 memerlukan FULLY_QUALIFIED_BUCKET_NAME. Gunakan perintah GET atau DESCRIBE dari bagian Lihat konfigurasi bucket untuk mendapatkan nama bucket yang sepenuhnya memenuhi syarat.

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

gdcloud storage cp *.txt s3://FULLY_QUALIFIED_BUCKET_NAME

Perintah berikut mengupload beberapa file dari direktori lokal ke bucket:

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

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

gdcloud storage cp dir s3://FULLY_QUALIFIED_BUCKET_NAME --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

Konsol

  1. Di menu navigasi, klik Object Storage.
  2. Klik nama bucket yang berisi objek.
  3. Centang kotak di samping nama objek yang akan didownload.
  4. Klik Download.

CLI

Untuk mendapatkan objek dari bucket:

gdcloud storage cp s3://FULLY_QUALIFIED_BUCKET_NAME/OBJECT LOCAL_FILE_TO_SAVE

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

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

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

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

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

gdcloud storage ls s3://FULLY_QUALIFIED_BUCKET_NAME/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://FULLY_QUALIFIED_BUCKET_NAME/abc.txt#OEQxNTk4MUEtMzEzRS0xMUVFLTk2N0UtQkM4MjAwQkJENjND .

Menggunakan AEADKey kustom

Untuk penyesuaian yang lebih besar, Anda dapat membuat AEADKey sendiri dan menggunakannya secara langsung saat mengenkripsi objek di bucket Anda. Tindakan ini memberi Anda kontrol penuh atas kunci enkripsi, sehingga menggantikan kunci default. Ikuti Membuat kunci untuk membuat AEADKey baru dan pastikan kunci tersebut berada di Namespace yang sama dengan bucket yang ingin Anda gunakan. Kemudian, setiap kali mengirim permintaan, pastikan HEADER dikonfigurasi dengan x-amz-server-side-encryption: SSE-KMS dan x-amz-server-side-encryption-aws-kms-key-id: NAMESPACE_NAME/AEADKey_NAME