全部产品
Search
文档中心

Object Storage Service:Bagaimana cara mengunggah dan mengunduh direktori ke/dari OSS?

更新时间:Mar 20, 2026

OSS menyimpan data sebagai objek dalam struktur datar, bukan sebagai sistem file hierarkis. Direktori di OSS merupakan objek yang namanya diakhiri dengan garis miring maju (/). Untuk membantu Anda mengorganisasi objek, OSS memungkinkan pengelompokan objek di bawah awalan umum yang berfungsi sebagai jalur direktori.

Tabel berikut merangkum dukungan pengunggahan dan pengunduhan direktori di berbagai alat OSS.

ToolUpload directoryDownload directory
OSS consoleDidukung (drag and drop)Tidak didukung secara langsung; unduh objek satu per satu
ossbrowserDidukung (klik atau drag)Didukung
ossutilDidukung (-r option)Didukung (opsi -r)
OSS SDKsTidak didukung secara langsung; unggah objek dengan awalan bersamaTidak didukung secara langsung; daftar dan unduh objek satu per satu

Use the OSS console

Upload a directory

Seret direktori ke area unggah. Struktur direktori akan dipertahankan di OSS. Lihat Upload objects.

Download a directory

Konsol OSS tidak mendukung pengunduhan direktori secara langsung. Unduh objek satu per satu ke direktori lokal Anda. Lihat Download objects.

Use ossbrowser

Upload a directory

Di bucket atau direktori target, klik FolderOperasi umum, lalu pilih direktori yang akan diunggah. Alternatifnya, seret direktori ke ossbrowser. Lihat Menggunakan ossbrowser.

Download a directory

Klik Download di kolom Tindakan untuk direktori tersebut. Lihat Menggunakan ossbrowser.Operasi umum.

Use ossutil

Upload a directory

Tentukan opsi -r saat mengunggah direktori. Untuk informasi selengkapnya, lihat Upload objects.

Download a directory

Tentukan opsi -r saat mengunduh direktori. Untuk informasi selengkapnya, lihat Download objects.

Use OSS SDKs

OSS SDK tidak mendukung pengunggahan atau pengunduhan direktori sebagai satu operasi tunggal. Gunakan pendekatan berikut sebagai gantinya.

Upload a directory

Untuk mengunggah beberapa file lokal ke direktori OSS yang sama, tetapkan awalan bersama untuk semua nama objek dan gunakan garis miring maju (/) sebagai pemisah.

Misalnya, untuk mengunggah example1.txt, example2.txt, dan example3.txt ke direktori dir/, atur nama objek menjadi dir/example1.txt, dir/example2.txt, dan dir/example3.txt.

Untuk contoh kode dalam berbagai bahasa, lihat Overview.

Download a directory

Untuk mengunduh semua objek dalam direktori OSS ke jalur lokal, pilih pendekatan yang sesuai dengan situasi Anda:

  • Jika Anda mengetahui nama objeknya: Tetapkan nama objek dan jalur lokal untuk setiap objek secara eksplisit. Misalnya, untuk mengunduh example1.jpg dan example2.jpg dari direktori folder/ ke local/folder/, atur nama objek menjadi folder/example1.jpg dan folder/example2.jpg, serta jalur lokal menjadi local/folder/example1.jpg dan local/folder/example2.jpg.

  • Jika Anda tidak mengetahui nama objeknya: Panggil GetBucket(ListObjects) untuk mencantumkan semua objek di bawah awalan direktori tersebut, lalu unduh setiap objek ke jalur lokal yang sesuai.

Untuk contoh kode dalam berbagai bahasa, lihat Overview.