全部产品
Search

搜索本产品

    Object Storage Service：Lihat opsi

    文档中心

    Object Storage Service：Lihat opsi

    更新时间：Mar 01, 2026

    Jalankan ossutil -h untuk menampilkan semua opsi yang didukung oleh ossutil.

    Mulai versi ossutil 1.6.16 dan seterusnya, gunakan ossutil sebagai nama biner di semua sistem operasi. Versi sebelumnya memerlukan nama biner yang spesifik untuk masing-masing sistem operasi. Untuk informasi selengkapnya, lihat referensi perintah ossutil.

    Sintaksis perintah

    ossutil -h

    Untuk melihat opsi suatu perintah tertentu, jalankan ossutil help [command]. Contoh:

    ossutil help cp

    Opsi umum

    Opsi berikut berlaku untuk sebagian besar perintah ossutil.

    OpsiDeskripsi
    -c, --config-filePath ke file konfigurasi ossutil. ossutil membaca file ini saat startup. Untuk mengelola bucket di berbagai Akun Alibaba Cloud, buat beberapa file konfigurasi dan tentukan salah satunya dengan opsi ini.
    -e, --endpointTitik akhir bucket. Gunakan opsi ini untuk mengelola bucket lintas wilayah. Untuk informasi lebih lanjut, lihat Wilayah dan titik akhir.
    -i, --access-key-idID AccessKey untuk mengakses Object Storage Service (OSS). Gunakan opsi ini untuk mengelola bucket yang dimiliki oleh Akun Alibaba Cloud yang berbeda.
    -k, --access-key-secretRahasia AccessKey untuk mengakses OSS. Gunakan opsi ini untuk mengelola bucket yang dimiliki oleh Akun Alibaba Cloud yang berbeda.
    -p, --passwordRahasia AccessKey untuk mengakses OSS, dimasukkan secara interaktif dari keyboard. Nilai ini menggantikan rahasia AccessKey yang dikonfigurasi melalui metode lain.
    --loglevelTingkat log untuk file ossutil.log yang dihasilkan di direktori kerja saat ini. Default: tidak ada file log yang dihasilkan. Nilai yang valid: info — mencatat operasi. Contoh: ossutil [command] --loglevel=info. debug — mencatat permintaan HTTP, tanggapan, dan string signature mentah untuk troubleshooting. Contoh: ossutil [command] --loglevel=debug.
    --proxy-host, --proxy-user, --proxy-pwdPengaturan server proxy. Tentukan ketiga opsi ini untuk mengarahkan traffic ossutil melalui proxy. --proxy-host: URL proxy. Mendukung HTTP, HTTPS, dan SOCKS5. --proxy-user: username proxy. Default: kosong. --proxy-pwd: password proxy. Default: kosong. Contoh: ossutil ls oss://bucket1 --proxy-host http://47.88.**:3128 --proxy-user test --proxy-pwd test
    --modeJenis kredensial untuk otentikasi. Nilai yang valid: AK — ID AccessKey dan rahasia AccessKey. StsToken — token Security Token Service (STS). RamRoleArn — AssumeRole melalui Resource Access Management (RAM). EcsRamRole — otentikasi tanpa password dari instans Elastic Compute Service (ECS). Default: logika otentikasi default.
    --ecs-role-nameNama role RAM untuk otentikasi EcsRamRole.
    --token-timeoutMasa berlaku token yang diperoleh melalui AssumeRole dalam otentikasi RamRoleArn. Default: 3600. Satuan: detik.
    --ram-role-arnAlibaba Cloud Resource Name (ARN) dari role RAM untuk otentikasi RamRoleArn.
    --role-session-nameNama sesi untuk otentikasi RamRoleArn.
    --read-timeoutTimeout baca klien. Default: 1200. Satuan: detik.
    --connect-timeoutTimeout koneksi klien. Default: 120. Satuan: detik.
    --sts-regionWilayah untuk titik akhir STS. Contoh: cn-hangzhou. Untuk semua wilayah yang didukung, lihat Titik akhir. Default: sts.aliyuncs.com.
    --skip-verify-certMelewati verifikasi sertifikat server.
    --uaNilai header User-Agent kustom. Nilai yang ditentukan akan ditambahkan ke string User-Agent default ossutil. Untuk melihat nilai User-Agent lengkap, gunakan --loglevel debug.

    Opsi khusus perintah

    Opsi berikut tersedia untuk perintah ossutil tertentu.

    OpsiDeskripsi
    -s, --short-formatMenampilkan item dalam format singkat. Default: format panjang.
    --bigfile-thresholdAmbang batas ukuran objek untuk unggah yang dapat dilanjutkan. Default: 104857600 (100 MB). Nilai yang valid: 0 hingga 9223372036854775807. Satuan: byte.
    --aclAccess control list (ACL) yang akan diterapkan.
    --rangeRentang byte objek yang akan diunduh. Byte dinomori mulai dari 0. Format: 3-9 — byte 3 hingga 9 (inklusif). 3- — byte 3 hingga akhir objek. -9 — byte 0 hingga byte 9 (inklusif).
    --all-versionsMenerapkan operasi ke semua versi objek.
    --typeAlgoritma untuk verifikasi data. Default: crc64. Nilai yang valid: crc64, md5.
    -v, --versionMenampilkan versi ossutil.
    -u, --updateMelakukan operasi inkremental.
    --originNilai header Origin dalam permintaan HTTP.
    --upmodeMetode unggah untuk perintah probe. Default: normal. Nilai yang valid: normal — unggah simple. append — unggah append. multipart — unggah multi-bagian.
    --sse-algorithmAlgoritma enkripsi sisi server untuk bucket. Nilai yang valid: KMS — enkripsi dengan kunci yang dikelola oleh Key Management Service (KMS) (SSE-KMS). AES256 — enkripsi dengan kunci yang dikelola oleh OSS (SSE-OSS).
    --includeHanya menyertakan objek yang sesuai dengan pola yang ditentukan. Contoh: *.jpg menyertakan semua objek JPG. Lihat perilaku pola --include dan --exclude.
    --excludeMengecualikan objek yang sesuai dengan pola yang ditentukan. Contoh: *.txt mengecualikan semua objek TXT. Lihat perilaku pola --include dan --exclude.
    -r, --recursiveMelakukan operasi secara rekursif pada semua objek yang sesuai dalam bucket. Tanpa opsi ini, hanya objek yang ditentukan dalam URL yang terpengaruh.
    --addrAlamat jaringan untuk pemeriksaan konektivitas. ossutil menjalankan ping ke alamat ini. Default: www.aliyun.com.
    --kms-masterkey-idID customer master key (CMK) untuk enkripsi KMS.
    --version-idID versi objek.
    --version-id-markerPosisi awal untuk mencantumkan versi objek. Mencantumkan versi dengan ID yang secara alfabetis berada setelah nilai ini. Memerlukan Pengendalian versi diaktifkan pada bucket.
    -m, --multipartMenerapkan operasi ke tugas unggah multi-bagian yang belum lengkap dalam bucket.
    -d, --directoryHanya mengembalikan objek dan subdirektori di direktori saat ini.
    --payerPihak yang membayar permintaan. Atur ke requester untuk mengaktifkan mode bayar-per-permintaan.
    --maxupspeedKecepatan unggah maksimum. Default: 0 (tidak terbatas). Satuan: KB/s.
    --maxdownspeedKecepatan unduh maksimum. Default: 0 (tidak terbatas). Satuan: KB/s.
    --retry-timesJumlah percobaan ulang saat terjadi error. Default: 10. Nilai yang valid: 1 hingga 500. Percobaan ulang dilakukan segera setelah terjadi error.
    --downloadMemeriksa konektivitas jaringan dengan mengunduh objek dari bucket menggunakan URL-nya.
    -j, --jobsJumlah tugas konkuren lintas beberapa objek. Default: 3. Nilai yang valid: 1 hingga 10000.
    -a, --all-typeMenerapkan operasi ke objek dan tugas unggah multi-bagian yang belum lengkap dalam bucket.
    --disable-empty-refererMemblokir permintaan dengan header Referer kosong.
    --methodMetode permintaan HTTP. Nilai yang valid: PUT, GET, DELETE.
    --output-dirDirektori untuk file output, seperti laporan error yang dihasilkan oleh perintah cp selama operasi batch. Default: ossutil_output di direktori saat ini.
    --metaMetadata objek dalam format [header:nilai#header:nilai...]. Contoh: Cache-Control:no-cache#Content-Encoding:gzip.
    --objectNama objek untuk perintah probe.
    --end-timeStempel waktu Linux/UNIX. Objek dengan waktu modifikasi terakhir lebih baru dari nilai ini diabaikan.
    --limited-numJumlah maksimum hasil yang dikembalikan.
    -L, --languageBahasa untuk output ossutil. Default: CH. Nilai yang valid: CH — Bahasa Tionghoa (memerlukan encoding UTF-8). EN — Bahasa Inggris.
    --deleteMenghapus bucket, objek, atau bagian yang ditentukan.
    -b, --bucketMenentukan bahwa operasi hapus menargetkan bucket.
    --disable-crc64Menonaktifkan verifikasi CRC-64 selama transfer data. Secara default, CRC-64 diaktifkan.
    --uploadMemeriksa konektivitas jaringan dengan mengunggah file lokal ke bucket.
    --part-sizeUkuran bagian untuk operasi multi-bagian. Secara default, ossutil menghitung ukuran yang sesuai berdasarkan objek. Nilai yang valid: 1 hingga 9223372036854775807. Satuan: byte.
    --timeoutMasa berlaku URL yang ditandatangani. Default: 60. Nilai yang valid: 0 hingga 9223372036854775807. Satuan: detik.
    --checkpoint-dirDirektori untuk menyimpan data checkpoint selama operasi unggah, unduh, atau salin yang dapat dilanjutkan. Jika tugas gagal, ossutil membuat direktori .ossutil_checkpoint dan menyimpan data checkpoint di sana. Saat berhasil, ossutil menghapus direktori tersebut. Jika Anda menentukan direktori kustom, pastikan direktori tersebut dapat dihapus.
    --urlURL objek.
    --markerPosisi awal untuk operasi daftar. Item (bucket, objek, atau bagian) dengan nama yang secara alfabetis berada setelah nilai ini akan dicantumkan.
    -f, --forceMemaksa operasi tanpa meminta konfirmasi.
    --snapshot-pathDirektori untuk menyimpan snapshot objek yang diunggah atau diunduh. Saat ditentukan, ossutil membaca data snapshot dan melakukan unggah atau unduh inkremental. Catatan penggunaan: Gunakan opsi ini untuk mempercepat unggah atau unduh inkremental sejumlah besar objek. Tidak didukung untuk operasi salin. Opsi ini mencatat waktu modifikasi terakhir objek secara lokal. Antara dua eksekusi, objek di OSS tidak boleh dimodifikasi oleh pengguna lain. Jika objek mungkin berubah antara eksekusi, gunakan --update sebagai gantinya untuk operasi inkremental. Data snapshot tidak dihapus secara otomatis. Hapus snapshot lama secara manual. Membaca dan menulis data snapshot menambah overhead. Untuk jumlah objek kecil atau kondisi jaringan baik, gunakan --update sebagai gantinya. Kedua opsi --update dan --snapshot-path dapat digabungkan. ossutil memeriksa snapshot terlebih dahulu, lalu menggunakan logika --update jika diperlukan.
    --start-timeStempel waktu Linux/UNIX. Objek dengan waktu modifikasi terakhir lebih lama dari nilai ini diabaikan.
    --storage-classKelas penyimpanan objek. Default: Standard. Nilai yang valid: Standard — untuk data yang sering diakses. IA — Akses Jarang. Penyimpanan minimum: 30 hari, ukuran tagihan minimum: 64 KB. Mendukung akses real-time. Dikenakan biaya pengambilan data. Archive — untuk penyimpanan jangka panjang. Penyimpanan minimum: 60 hari, ukuran tagihan minimum: 64 KB. Memerlukan restorasi (sekitar 1 menit). Dikenakan biaya pengambilan data. ColdArchive — untuk penyimpanan jangka panjang yang jarang diakses. Penyimpanan minimum: 180 hari, ukuran tagihan minimum: 64 KB. Memerlukan restorasi (waktu bervariasi tergantung ukuran objek dan mode restorasi). Dikenakan biaya pengambilan data.
    -t, --sts-tokenToken STS untuk akses temporary ke OSS. Hanya diperlukan untuk otentikasi berbasis STS. Nilai ini menggantikan token dalam file konfigurasi. Untuk informasi lebih lanjut, lihat Unggah pihak ketiga yang diotorisasi.
    --parallelJumlah operasi konkuren pada satu objek. Default: dihitung otomatis berdasarkan jenis operasi dan ukuran objek. Nilai yang valid: 1 hingga 10000.
    --partition-downloadPartisi untuk diunduh, dalam format nomor_partisi:total_partisi. Contoh: 1:5 mengunduh partisi 1 dari 5. Partisi dinomori mulai dari 1, dan pembagian partisi ditentukan oleh ossutil. Gunakan opsi ini untuk membagi objek ke beberapa perintah ossutil konkuren, masing-masing mengunduh partisinya sendiri.
    --bucketnameNama bucket.
    --encoding-typeJenis encoding untuk kunci objek setelah oss://bucket_name. Nilai yang valid: url. Default: tanpa encoding.
    --originNilai header Origin dalam permintaan HTTP, yang menentukan domain asal untuk permintaan lintas asal.
    --acr-methodNilai header Access-Control-Request-Method. Nilai yang valid: GET, PUT, POST, DELETE, HEAD.
    --acr-headersNilai header Access-Control-Request-Headers. Menentukan header permintaan non-standar. Pisahkan beberapa header dengan koma dan masukkan dalam tanda kutip ganda. Contoh: --acr-headers "header1,header2,header3".
    --upload-id-markerPosisi awal untuk mencantumkan tugas unggah multi-bagian. Mencantumkan tugas dengan ID unggah yang secara alfabetis berada setelah nilai ini.
    -h, --helpMenampilkan informasi bantuan untuk suatu perintah.
    --trafic-limitBatas kecepatan akses HTTP untuk URL yang ditandatangani. Default: 0 (tidak terbatas). Nilai yang valid: 819200 hingga 838860800 (100 KB/s hingga 100 MB/s). Satuan: bit/s.
    --local-hostAlamat IP lokal yang digunakan ossutil dengan perintah cp.
    --enable-symlink-dirMengunggah subdirektori yang ditunjuk oleh tautan simbolik. Secara default, subdirektori ini tidak diunggah. Gunakan perintah probe untuk memeriksa apakah target symlink juga merupakan tautan simbolik.
    --only-current-dirMengunggah, mengunduh, atau menyalin hanya objek di direktori saat ini. Mengabaikan subdirektori dan isinya.
    --disable-dir-objectMencegah pembuatan objek OSS untuk direktori yang diunggah. Struktur direktori tetap dipertahankan di Konsol OSS, tetapi menghapus semua objek dalam direktori juga akan menghapus direktori tersebut.
    --probe-itemItem yang diperiksa dengan perintah probe. Nilai yang valid: upload-speed — memeriksa bandwidth unggah. download-speed — memeriksa bandwidth unduh. cycle-symlink — memeriksa apakah tautan simbolik lokal menunjuk ke dirinya sendiri.
    --redundancy-typeJenis redundansi data bucket. Default: LRS. Nilai yang valid: LRS — penyimpanan redundan lokal. Menyimpan salinan setiap objek di berbagai perangkat dalam zona yang sama. ZRS — penyimpanan redundan zona. Menyimpan salinan di beberapa zona dalam wilayah yang sama, memberikan ketersediaan bahkan jika satu zona tidak tersedia.
    --disable-encode-slashMencegah encoding garis miring maju (/) dalam URL.
    --disable-all-symlinkMengabaikan semua tautan simbolik dan subdirektori targetnya selama unggah.
    --taggingTag objek yang diterapkan selama unggah atau salin. Contoh: "abc=1&bcd=2&...".
    --disable-ignore-errorMenghentikan operasi batch saat terjadi error, bukan mengabaikan error tersebut.
    --block-sizeSatuan untuk menampilkan ukuran total objek dalam bucket atau direktori. Nilai yang valid: KB, MB, GB, TB. Default: byte.
    Penting

    Tersedia di ossutil 1.7.3 dan versi selanjutnya.

    Perilaku pola --include dan --exclude

    Evaluasi kiri ke kanan

    Satu aturan dapat mencakup beberapa kondisi --include dan --exclude. ossutil mengevaluasi kondisi tersebut dari kiri ke kanan untuk menentukan hasil akhir. Misalnya, diberikan objek test.txt di direktori target:

    • Aturan 1: --include "*test*" --exclude "*.txt" — ossutil pertama-tama mengevaluasi --include "*test*" dan menyertakan test.txt karena cocok. Kemudian, ossutil mengevaluasi --exclude "*.txt" dan mengecualikan test.txt karena cocok dengan *.txt. Hasil: diecualikan.

    • Aturan 2: --exclude "*.txt" --include "*test*" — ossutil pertama-tama mengevaluasi --exclude "*.txt" dan mengecualikan test.txt. Kemudian, ossutil mengevaluasi --include "*test*" dan menyertakan kembali test.txt karena cocok. Hasil: disertakan.

    • Aturan 3: --include "*test*" --exclude "*.txt" --include "te?t.txt" — ossutil mengevaluasi --include "*test*" (disertakan), lalu --exclude "*.txt" (diecualikan), lalu --include "te?t.txt" (disertakan). Hasil: disertakan.

    Pola wildcard

    PolaDeskripsiContoh
    *Cocok dengan sejumlah karakter apa pun.*.txt cocok dengan semua file TXT.
    ?Cocok dengan satu karakter.abc?.jpg cocok dengan abc1.jpg, abcX.jpg, dll.
    [sequence]Cocok dengan karakter apa pun dalam urutan tersebut.abc[1-5].jpg cocok dengan abc1.jpg hingga abc5.jpg.
    [!sequence]Cocok dengan karakter apa pun yang tidak termasuk dalam urutan tersebut.abc[!0-7].jpg cocok dengan objek seperti abc8.jpg dan abc9.jpg, tetapi tidak cocok dengan abc0.jpg hingga abc7.jpg.

    Batasan

    Path direktori tidak dapat ditentukan dalam pola --include atau --exclude. Misalnya, perintah berikut menghasilkan error --include or --exclude does not support format containing dir info:

    ossutil cp oss://examplebucket/destfolder/ localfolder/ --include "dir/"