All Products
Search
Document Center

Cloud Storage Gateway:Pengunduhan data

Last Updated:May 08, 2026

Dalam mode replikasi, Anda dapat menggunakan fitur pengunduhan data dari File Gateway untuk mengunduh data dari bucket OSS ke klien lokal.

Prasyarat

  • File Gateway telah dibuat, dan disk cache telah disambungkan ke gateway tersebut.

  • Bucket OSS telah dibuat. Untuk informasi selengkapnya, lihat Console quick start.

    Penting
    • File Gateway mendukung bucket OSS dengan jenis Penyimpanan Standar, Akses Jarang (IA), dan Arsip. Bucket dengan mirroring-based back-to-origin tidak didukung.

    • Jangan mengaitkan gateway dengan bucket Arsip. Sebagai gantinya, simpan file di bucket Standar atau IA dan konfigurasikan aturan siklus hidup untuk memindahkannya ke Arsip atau Cold Archive. Hal ini menghindari operasi pemulihan yang tidak perlu.

    • Saat klien menulis file, gateway memanggil CopyObject untuk menyimpan waktu modifikasi file sebagai metadata objek. Untuk objek Arsip atau Cold Archive, CopyObject memicu pemulihan, yang memperlambat unggahan dan dapat menyebabkan kegagalan unggahan.

  • File Gateway menggunakan sinkronisasi terbalik (reverse synchronization) atau sinkronisasi cepat (express synchronization). Untuk informasi selengkapnya, lihat Express synchronization.

Informasi latar belakang

Secara default, File Gateway menyinkronkan metadata dari bucket OSS ke klien lokal menggunakan sinkronisasi terbalik atau sinkronisasi cepat. Dalam mode replikasi, satu salinan data disimpan di klien lokal dan salinan lainnya disimpan di bucket OSS. Fitur pengunduhan data memungkinkan File Gateway mengunduh data file dari direktori tertentu atau semua data file yang disinkronkan melalui sinkronisasi terbalik atau sinkronisasi cepat ke klien lokal.

Mengunduh data melalui internet akan dikenai biaya OSS. Gunakan fitur ini sesuai kebutuhan. Untuk informasi selengkapnya, lihat Billing overview.

Aktifkan pengunduhan data untuk share baru

  1. Pada halaman Gateway List di Konsol Cloud Storage Gateway, temukan dan klik File Gateway target, lalu klik Shares.

  2. Pada kotak dialog Create Share, konfigurasikan parameter pada bagian Bucket Settings dan Basic Information, lalu pilih Advanced Settings. Untuk informasi selengkapnya, lihat Create a share.

  3. Pada bagian Advanced Settings, konfigurasikan parameter berikut dan klik Next.

    Parameter

    Deskripsi

    Mode

    Pilih Replication Mode.

    Reverse Sync

    Aktifkan Reverse Sync. Fitur ini menyinkronkan metadata dari bucket OSS ke klien lokal dan cocok untuk skenario disaster recovery gateway, pemulihan data, dan berbagi data.

    Sinkronisasi terbalik hanya dipicu saat sebuah direktori diakses. Untuk memastikan data di direktori yang tidak diakses dan data baru segera diunduh, gunakan sinkronisasi cepat. Untuk informasi selengkapnya, lihat Express synchronization.

    Catatan
    • Sinkronisasi terbalik memindai semua objek dalam bucket. Jika bucket berisi banyak objek, biaya permintaan API OSS akan dikenakan. Untuk informasi selengkapnya, lihat biaya permintaan pada halaman Object Storage Service (OSS) pricing.

    • Jika Anda memilih Add to Sync Group pada bagian Basic Information, opsi ini tidak tersedia.

    Reverse Sync Interval

    Nilainya harus berada dalam rentang 15 detik hingga 36000 detik.

    Catatan

    Jika bucket berisi banyak objek, atur interval sinkronisasi terbalik lebih dari 3.600 detik. Jika tidak, pemindaian yang sering dapat menghasilkan biaya permintaan API OSS yang tinggi.

    Replication Mode Advanced Settings

    Pilih Replication Mode Advanced Settings.

  4. Pada bagian Replication Mode Advanced Settings, konfigurasikan parameter berikut untuk mengaktifkan Data Download.

    Parameter

    Deskripsi

    Configure Directory in Replication Mode

    Parameter ini menentukan cakupan data file yang berjalan dalam mode replikasi.

    • Jika parameter ini tidak dipilih, semua data dalam share secara default berjalan dalam mode replikasi.

    • Jika parameter ini dipilih, klik Add Directory dan masukkan jalur direktori data target. Data pada jalur direktori yang ditentukan berjalan dalam mode replikasi, sedangkan data pada jalur yang tidak ditentukan berjalan dalam mode cache.

    Catatan
    • Saat Anda mengubah direktori dari mode cache ke mode replikasi, file dalam direktori tersebut hanya akan disinkronkan jika pengunduhan data diaktifkan. Aktifkan fitur pengunduhan data untuk mode replikasi secara bersamaan.

    • Jalur direktori yang ditentukan adalah jalur relatif berdasarkan Direktori root share. Misalnya, jika jalur mutlak direktori yang ingin Anda aktifkan untuk mode replikasi adalah /mnt/myshare/mydir/ dan titik mount-nya adalah /mnt/myshare, masukkan /mydir/.

    Data Download

    Saat pengunduhan data diaktifkan, sinkronisasi terbalik atau sinkronisasi cepat akan mengunduh metadata dan data file. Jika tidak, hanya metadata yang disinkronkan.

    Catatan
    • Untuk mengunduh data file dalam mode replikasi, kapasitas disk cache harus minimal 1,1 kali ukuran total file yang akan direplikasi. Rencanakan kapasitas disk cache berdasarkan perkiraan pertumbuhan penggunaan bucket.

    • Mengaktifkan pengunduhan data untuk pertama kalinya memicu pemindaian penuh, yang dapat memengaruhi kinerja gateway. Pastikan gateway dalam keadaan idle saat mengaktifkan fitur ini dan tetap idle hingga semua data selesai diunduh.

    • Fitur pengunduhan data hanya mendukung skenario single-writer, multiple-reader. Jika bucket terkait memiliki beberapa accessor (seperti gateway dan akses OSS langsung), hanya satu accessor yang dapat mengunggah file ke bucket tersebut. Accessor lain hanya dapat mengunduh file. Kehilangan data dapat terjadi dalam skenario multiple-writer, multiple-reader. Gunakan fitur ini dengan hati-hati.

    Download Speed Limit

    Konfigurasikan parameter ini saat Anda mengaktifkan Data Download. Batas kecepatan unduh harus berada dalam rentang 0 MB/detik hingga 1280 MB/detik, termasuk. Nilai 0 MB/detik berarti kecepatan unduh tidak dibatasi.

    Reverse Sync Interval

    Konfigurasikan parameter ini saat Anda mengaktifkan Data Download. Nilainya harus berada dalam rentang 3600 detik hingga 36000 detik.

    Catatan
    • Jika bucket berisi banyak objek, atur interval sinkronisasi terbalik lebih dari 3.600 detik. Jika tidak, pemindaian yang sering dapat menghasilkan biaya permintaan API OSS yang tinggi.

    • Sinkronisasi terbalik hanya dipicu saat sebuah direktori diakses. Untuk memastikan data di direktori yang tidak diakses dan data baru segera diunduh, gunakan express synchronization.

Aktifkan pengunduhan data untuk share yang sudah ada

  1. Di Konsol CSG, pada halaman Gateways, temukan dan klik File Gateway target.

  2. Pada tab Shares, temukan share target dan klik Advanced Settings di kolom Actions.

  3. Pada halaman Share Advanced Settings, konfigurasikan parameter berikut untuk mengaktifkan Data Download.

    Parameter

    Deskripsi

    Mode

    Anda hanya dapat menggunakan fitur Data Download dalam Replication Mode.

    Reverse Sync

    Aktifkan Reverse Sync. Fitur ini menyinkronkan metadata dari bucket OSS ke klien lokal dan cocok untuk skenario disaster recovery gateway, pemulihan data, dan berbagi data.

    Sinkronisasi terbalik hanya dipicu saat sebuah direktori diakses. Untuk memastikan data di direktori yang tidak diakses dan data baru segera diunduh, gunakan sinkronisasi cepat. Untuk informasi selengkapnya, lihat Express synchronization.

    Catatan
    • Sinkronisasi terbalik memindai semua objek dalam bucket. Jika bucket berisi banyak objek, biaya permintaan API OSS akan dikenakan. Untuk informasi selengkapnya, lihat biaya permintaan pada halaman Object Storage Service (OSS) pricing.

    • Jika Anda memilih Add to Sync Group pada bagian Basic Information, opsi ini tidak tersedia.

    Data Download

    Saat pengunduhan data diaktifkan, sinkronisasi terbalik atau sinkronisasi cepat akan mengunduh metadata dan data file. Jika tidak, hanya metadata yang disinkronkan.

    Catatan
    • Untuk mengunduh data, kapasitas disk cache harus minimal 1,1 kali ukuran total file yang akan direplikasi. Rencanakan kapasitas disk cache berdasarkan perkiraan pertumbuhan penggunaan bucket.

    • Mengaktifkan pengunduhan data untuk pertama kalinya memicu pemindaian penuh, yang dapat memengaruhi kinerja gateway. Pastikan gateway dalam keadaan idle saat mengaktifkan fitur ini dan tetap idle hingga semua data selesai diunduh.

    • Fitur pengunduhan data hanya mendukung skenario single-writer, multiple-reader. Jika bucket terkait memiliki beberapa accessor (seperti gateway dan akses OSS langsung), hanya satu accessor yang dapat mengunggah file ke bucket tersebut. Accessor lain hanya dapat mengunduh file. Kehilangan data dapat terjadi dalam skenario multiple-writer, multiple-reader. Gunakan fitur ini dengan hati-hati.

    Download Speed Limit

    Konfigurasikan parameter ini saat Anda mengaktifkan Data Download. Batas kecepatan unduh harus berada dalam rentang 0 MB/detik hingga 1280 MB/detik, termasuk. Nilai 0 MB/detik berarti kecepatan unduh tidak dibatasi.