All Products
Search

This Product

    Object Storage Service:Perintah lanjutan

    Document Center

    Object Storage Service:Perintah lanjutan

    Last Updated:Aug 29, 2026

    Konfigurasikan opsi lanjutan ossutil untuk operasi batch, filtering, metadata, dan kontrol transfer.

    Deskripsi perintah

    Ruang lingkup perintah

    Opsi yang didukung

    Semua perintah lanjutan

    • --encoding-type string: Encoding untuk nama objek atau file input. Nilai yang valid: url.

    • --request-payer string: Mengaktifkan mode pay-by-requester. Atur ke `requester`.

    Perintah yang mendukung operasi batch

    • --start-after/--end-with (, ]: Filter rentang kunci. Mulai eksklusif, akhir inklusif.

    • opsi filter: Filter berdasarkan nama objek/file, folder, ukuran, waktu, atau metadata. Opsi filter.

    • --limited-num: Membatasi jumlah hasil yang dikembalikan per kueri API.

    • --recursive/-r: Melakukan rekursi ke semua subdirektori.

    • --dirs/-d: Hanya mencantumkan direktori saat ini, tidak termasuk subdirektori.

      Catatan

      Untuk objek, metode ini menggunakan Delimiter dan memindai semua objek di bawah awalan tersebut. Semakin banyak objek, semakin lama waktu pemindaian.

    • --force/-f: Memaksa operasi tanpa prompt konfirmasi.

    • --list-objects: Menggunakan API ListObjects untuk mencantumkan objek.

    Perintah yang mendukung aturan filtering tujuan

    • --update: Hanya membandingkan waktu modifikasi. Menyinkronkan hanya jika sumber lebih baru daripada tujuan.

    • --size-only: Hanya membandingkan ukuran file. Menyinkronkan hanya data dengan ukuran file yang berbeda.

    • --checksum: Membandingkan ukuran file terlebih dahulu, lalu checksum CRC-64. Jika checksum tidak tersedia di salah satu sisi, file dianggap tidak konsisten. Hanya berlaku untuk copy objek-ke-objek.

    • --ignore-existing: Melewatkan file yang sudah ada.

    Perintah yang mendukung objek tunggal

    --version-id string: ID versi objek.

    Perintah yang mendukung mode daftar

    --list-format: Format file daftar. Nilai yang valid: plain dan inventory.

    --list-manifest-from: Membaca deskripsi format file daftar dari sebuah file. Parameter ini wajib digunakan ketika format file daftar adalah inventory.

    Opsi lokal

    Opsi lokal

    Jenis opsi

    Deskripsi

    --encoding-type

    string

    Encoding untuk nama objek atau file input. Nilai yang valid: url.

    --request-payer

    string

    Mengaktifkan mode pay-by-requester. Nilai yang valid: requester.

    --start-after

    string

    Mengembalikan objek secara alfabetis setelah nilai yang ditentukan (eksklusif).

    --end-with

    string

    Mengembalikan objek secara alfabetis hingga nilai yang ditentukan (inklusif).

    --page-size

    int

    Jumlah maksimum objek per halaman dalam pemrosesan batch. Default: 1000. Rentang: 1 hingga 1000.

    --include

    stringArray

    Aturan inklusi untuk path atau nama file.

    --include-from

    stringArray

    Membaca aturan inklusi dari file aturan.

    --exclude

    stringArray

    Aturan eksklusi untuk path atau nama file.

    --exclude-from

    stringArray

    Membaca aturan eksklusi dari file aturan.

    --filter

    stringArray

    Aturan filter untuk path atau nama file.

    --files-from

    stringArray

    Membaca daftar nama file sumber dari sebuah file. Baris kosong atau baris komentar diabaikan. Ini hanya berlaku untuk operasi filtering file.

    --files-from-raw

    stringArray

    Membaca daftar nama file sumber dari sebuah file. Ini hanya berlaku untuk operasi filtering file.

    --max-age

    Duration

    Melewatkan file yang lebih tua dari usia ini. Satuan default: detik. Mendukung sufiks: ms, s, m, h, d, w, M, y. Default: nonaktif.

    --min-age

    Duration

    Melewatkan file yang lebih baru dari usia ini. Satuan default: detik. Mendukung sufiks: ms, s, m, h, d, w, M, y. Default: nonaktif.

    --max-mtime

    Time

    Melewatkan file yang lebih baru dari timestamp UTC ini. Default: nonaktif.

    --min-mtime

    Time

    Melewatkan file yang lebih tua dari timestamp UTC ini. Default: nonaktif.

    --max-size

    SizeSuffix

    Ukuran file maksimum untuk ditransfer. Satuan default: byte. Mendukung sufiks: B, K, M, G, T, P. 1 K (KiB) = 1024 B.

    --min-size

    SizeSuffix

    Ukuran file minimum untuk ditransfer. Satuan default: byte. Mendukung sufiks: B, K, M, G, T, P. 1 K (KiB) = 1024 B.

    --metadata-exclude

    stringArray

    Aturan eksklusi untuk metadata objek.

    --metadata-include

    stringArray

    Aturan inklusi untuk metadata objek.

    --metadata-filter

    stringArray

    Aturan filter untuk metadata objek.

    --metadata-filter-from

    stringArray

    Membaca aturan filter metadata objek dari file aturan.

    --checksum

    /

    Hanya menyalin file sumber yang ukuran dan checksum-nya (jika ada) tidak konsisten.

    --size-only

    /

    Hanya menyalin file sumber dengan ukuran yang tidak konsisten.

    -u, --update

    /

    Hanya menyalin file sumber yang lebih baru daripada file tujuan.

    -r, --recursive

    /

    Beroperasi pada semua objek yang sesuai di bucket secara rekursif. Tanpa opsi ini, hanya beroperasi pada path yang ditentukan.

    -d, --dirs

    /

    Hanya mencantumkan file dan subdirektori di folder saat ini, tanpa rekursi.

    -f, --force

    /

    Memaksa operasi tanpa prompt konfirmasi.

    --list-objects

    /

    Menggunakan API ListObjects untuk mencantumkan objek.

    --no-progress

    /

    Tidak menampilkan bilah progres.

    -j, --job

    int

    Tugas konkuren untuk operasi multi-file. Default: 3.

    --checkers

    int

    Pemeriksa paralel. Default: 16.

    --parallel

    int

    Tugas konkuren untuk operasi multipart file tunggal.

    --part-size

    SizeSuffix

    Ukuran bagian untuk operasi multipart. Dihitung otomatis secara default. Rentang: 100 KiB hingga 5 GiB.

    --bigfile-threshold

    int

    Ambang batas ukuran untuk unggah, unduh, atau salin multipart. Default: 104857600 (100 MiB).

    --version-id

    string

    ID versi objek.

    --storage-class

    string

    Kelas penyimpanan objek. Nilai yang valid: Standard, IA, Archive, ColdArchive, dan DeepColdArchive.

    --acl

    string

    Izin akses objek. Nilai yang valid: private, public-read, public-read-write, dan default.

    --cache-control

    string

    Mengontrol perilaku cache browser saat objek diunduh.

    --content-disposition

    string

    Format tampilan objek.

    --content-encoding

    string

    Encoding konten objek.

    --content-type

    string

    Tipe konten objek.

    --expires

    string

    Waktu kedaluwarsa absolut untuk konten yang di-cache.

    --copy-props

    string

    Properti yang disalin dari objek sumber. Nilai yang valid: none, metadata, default.

    --tagging

    string

    Tag objek dalam format key=value.

    --tagging-directive

    string

    Cara mengatur tag objek tujuan. Nilai yang valid: COPY, REPLACE.

    --metadata

    string

    Metadata pengguna dalam format key=value.

    --metadata-directive

    string

    Cara mengatur metadata objek tujuan. Nilai yang valid: COPY, REPLACE.

    --list-format

    string

    Format file daftar. Nilai yang valid: plain dan inventory.

    --list-manifest-from

    string

    Membaca deskripsi format file daftar dari sebuah file. Parameter ini wajib digunakan ketika format file daftar adalah inventory.

    Opsi filter

    Opsi filter berlaku untuk perintah batch (ls, cp, sync, rm) dan memungkinkan penyaringan berdasarkan path/nama file, daftar file, waktu modifikasi, ukuran file, atau metadata objek.

    Opsi filter hanya tersedia di command line, bukan dalam file konfigurasi.

    Uji konfigurasi filter menggunakan perintah ls atau opsi --dry-run/-n sebelum menerapkan perubahan.

    Filter berdasarkan path/nama file

    Tentukan aturan filter untuk menentukan file yang akan disertakan atau dikecualikan berdasarkan nama atau path-nya.

    Aturan dapat ditentukan menggunakan opsi --include dan --exclude. Contohnya: --include="*.txt" dan --exclude="*".

    Aturan dapat ditentukan melalui opsi command-line atau file aturan. Beberapa aturan membentuk daftar terurut yang menyaring hasil berdasarkan prinsip-prinsip berikut:

    • Aturan diproses secara berurutan: parameter dalam perintah dari kiri ke kanan, sedangkan aturan dalam file dari atas ke bawah.

    • Setiap file atau path diperiksa terhadap aturan untuk menentukan apakah harus disertakan atau dikecualikan.

    • Pemeriksaan dilakukan secara berurutan dan berhenti segera setelah ditemukan aturan yang cocok.

    • Jika tidak ada aturan yang cocok, file atau path tersebut disertakan secara default.

    • Pada sistem file lokal, jika suatu folder dikecualikan, semua subfolder dan file di dalamnya juga dikecualikan.

    • Karena bucket tidak memiliki struktur folder, setiap objek difilter secara individual.

    Pola pencocokan glob digunakan. Berikut adalah aturan umum untuk pola pencocokan glob:

    • Jika pola dimulai dengan /, pola tersebut harus cocok dengan awal path. Jika tidak, pola tersebut dapat cocok dengan nama di tingkat mana pun dalam path.

    • Jika pola diakhiri dengan /, pola tersebut hanya cocok dengan folder. Jika tidak, pola tersebut dapat cocok dengan folder atau file. Misalnya, dir/.

    • Karakter / merepresentasikan pemisah path. Misalnya, subdir/test.txt.

    • * mencocokkan string karakter apa pun dengan panjang berapa pun, tetapi tidak mencocokkan /. Misalnya, *.txt.

    • Jika pola diakhiri dengan **, pola tersebut mencocokkan string karakter apa pun dengan panjang berapa pun, termasuk /. Misalnya, dir/** mencocokkan path "dir/subdir/xx/test.txt".

    • ? mencocokkan satu karakter apa pun kecuali /.

    • [] mencocokkan satu karakter dari kelas tertentu. Misalnya, [a-z] mencocokkan huruf kecil, dan [0-9] mencocokkan digit.

    • Secara default, pola harus mencocokkan seluruh nama file atau folder. Misalnya, `foo` mencocokkan "foo" dan "dir/foo", tetapi tidak mencocokkan "dir/foo1" atau "foo/xx".

    • Pola harus mencocokkan nama folder atau file secara lengkap, bukan sebagian. Misalnya, `foo` tidak mencocokkan "xxx/afoo", dan `abc/foo` tidak mencocokkan "subdir/aabc/foo".

    Catatan

    Di Windows, gunakan / sebagai pemisah path, bukan \.

    Anda dapat membuat daftar terurut aturan filter path dan nama file dengan menentukan satu atau beberapa sintaks dan parameter berikut di command line:

    Item

    Deskripsi

    Sintaks aturan filter

    • pola aturan parameter opsi aturan: Pola pencocokan Glob.

    • nama file aturan parameter opsi aturan: Path file yang berisi aturan pola pencocokan Glob.

    • pengubah aturan pola aturan parameter opsi aturan: Pola pencocokan Glob instruksi. Instruksi + menunjukkan aturan inklusi. Objek yang cocok dengan aturan ini disertakan dalam hasil. Instruksi - menunjukkan aturan eksklusi. Objek yang cocok dengan aturan ini dikecualikan dari hasil.

    Parameter opsi aturan filter

    • --include

    • --include-from

    • --exclude

    • --exclude-from

    • --filter

    • --filter-from

    Tabel berikut menjelaskan opsi umum:

    Opsi

    Deskripsi

    --include

    --exclude

    Parameter diikuti oleh pola pencocokan. Setiap opsi merepresentasikan satu aturan. Untuk menggunakan beberapa aturan, ulangi opsi ini.

    Misalnya, --include "*.txt" --include "*.js" --exclude "*.jpg" menyertakan semua file .txt dan .js, tetapi mengecualikan semua file .jpg.

    Contoh perintah berikut mengunduh file secara rekursif yang sesuai dengan aturan filter dari folder oss://examplebucket/exampledir/ di Alibaba Cloud OSS ke folder localdir/. Aturan tersebut menyertakan semua file .txt dan .js, tetapi mengecualikan semua file .jpg.

    ossutil cp -r oss://examplebucket/exampledir/ localdir/ --include "*.txt" --include "*.js" --exclude "*.jpg"

    --filter

    Parameter diikuti oleh pola pencocokan instruksi. Setiap nilai opsi merepresentasikan satu aturan. Untuk menggunakan beberapa aturan, ulangi opsi ini.

    Misalnya, --filter "+ *.txt" --filter "+ *.js" --filter "- *.jpg" menyertakan semua file .txt dan .js, tetapi mengecualikan semua file .jpg.

    • Simbol + menunjukkan aturan inklusi. Objek yang cocok dengan aturan ini disertakan dalam hasil.

    • Simbol - menunjukkan aturan eksklusi. Objek yang cocok dengan aturan ini dikecualikan dari hasil.

    Contoh perintah berikut mengunduh file secara rekursif yang sesuai dengan aturan filter dari folder oss://examplebucket/exampledir/ di Alibaba Cloud OSS ke folder localdir/. Aturan tersebut mengecualikan file .txt dan .js, dan hanya menyertakan file .png.

    ossutil cp -r oss://examplebucket/exampledir/ localdir/ --filter "- *.txt" --filter "- *.js" --filter "+ *.png"

    --include-from

    --exclude-from

    Parameter diikuti oleh path file aturan. Setiap baris dalam file aturan merepresentasikan pola pencocokan Glob. Untuk mengimpor beberapa file aturan, ulangi opsi ini.

    Semua aturan yang diimpor dengan --include-from adalah aturan inklusi. Semua aturan yang diimpor dengan --exclude-from adalah aturan eksklusi.

    Misalnya, --include-from include-file.txt --exclude-from exclude-file.txt menyertakan semua file .txt dan .js, tetapi mengecualikan semua file .jpg.

    Isi file aturan include-file.txt adalah sebagai berikut:

     *.txt
 *.js

    File aturan include-file.txt berisi hal-hal berikut:

     *.jpg

    --filter-from

    Parameter diikuti oleh path file aturan. Setiap baris dalam file aturan merepresentasikan pola pencocokan Glob instruksi.

    Untuk mengimpor beberapa file aturan, ulangi opsi ini.

    Misalnya, dalam --filter-from filter-file.txt, isi file aturan filter-file.txt adalah sebagai berikut:

     # a filter rule file
 + *.txt
 + *.js
 - **

    Informasi tambahan:

    • Saat membaca aturan dari file, aturan diproses dari atas ke bawah. Baris kosong dan baris komentar yang dimulai dengan # atau ; diabaikan.

    • Jika path file adalah -, aturan dibaca dari standard input (stdin). Opsi ini hanya dapat ditentukan sekali.

    • Jika menggunakan aturan --include atau --include-from, aturan - ** ditambahkan ke akhir daftar aturan.

    • Jika menggunakan --filter + pattern, aturan - ** tidak ditambahkan ke akhir daftar aturan.

    Misalnya, untuk mengonfigurasi aturan yang hanya menyertakan file berekstensi .jpg menggunakan --filter, tentukan `--filter "+ *.jpg" --filter "- **"`.

    Catatan

    Opsi --filter atau --filter-from tidak dapat digunakan bersamaan dengan opsi --include, --include-from, --exclude, atau --exclude-from.

    Filter berdasarkan daftar path/file

    Anda dapat menentukan daftar path atau nama file melalui opsi command-line. Opsi yang didukung adalah sebagai berikut:

    Opsi

    Deskripsi

    --files-from

    Membaca daftar path/nama file dari sebuah file. Anda dapat mengulangi opsi ini untuk menggunakan beberapa file daftar.

    Saat memproses setiap baris dalam file daftar, spasi awal atau akhir dihapus, dan baris komentar yang dimulai dengan # atau ; diabaikan.

    --files-from-raw

    Membaca daftar path/nama file dari sebuah file. Anda dapat mengulangi opsi ini untuk menggunakan beberapa file daftar.

    Saat memproses setiap baris dalam file daftar, spasi awal atau akhir dan baris komentar yang dimulai dengan # atau ; tidak diabaikan.
    Catatan

    Jika Anda menentukan daftar path atau file yang akan dicocokkan, aturan pencocokan pola lainnya diabaikan.

    Filter berdasarkan waktu file

    Filter berdasarkan waktu modifikasi terakhir untuk mentransfer hanya file dalam rentang waktu tertentu.

    Filter waktu mendukung mode relatif dan absolut:

    Parameter

    Deskripsi

    --min-age

    Duration

    Hanya memproses file yang dimodifikasi sebelum interval yang ditentukan. Satuan default: detik. Mendukung sufiks satuan, misalnya 1h.

    Catatan

    --min-age 1h berarti memproses file yang dimodifikasi 1 jam yang lalu atau lebih awal.

    --max-age

    Duration

    Hanya memproses file yang dimodifikasi dalam interval yang ditentukan. Satuan default: detik. Mendukung sufiks satuan, misalnya 1h.

    Catatan

    --max-age 1h berarti memproses file yang dimodifikasi dalam 1 jam terakhir.

    --min-mtime

    Time

    Hanya memproses file yang dimodifikasi setelah waktu yang ditentukan.

    Catatan

    --min-mtime "2006-01-02T15:04:05" berarti memproses file yang dimodifikasi setelah pukul 15:04:05 pada 2 Januari 2006 (zona waktu lokal).

    --max-mtime

    Time

    Hanya memproses file yang dimodifikasi sebelum waktu yang ditentukan.

    Catatan

    --max-mtime "2006-01-02T15:04:05" berarti memproses file yang dimodifikasi sebelum pukul 15:04:05 pada 2 Januari 2006 (zona waktu lokal).

    Informasi tambahan:

    • Sufiks satuan yang didukung untuk --min-age dan --max-age: ms (milidetik), s (detik), m (menit), h (jam), d (hari), w (minggu), M (bulan), y (tahun).

    • Nilai desimal didukung, misalnya 1,5d untuk satu setengah hari.

    • Format waktu yang didukung untuk --min-mtime dan --max-mtime: 2006-01-02T15:04:05Z07:00 (RFC3339), 2006-01-02T15:04:05, 2006-01-02 15:04:05, 2006-01-02.

    • Jika waktu mencakup zona waktu (misalnya, diakhiri dengan Z atau +08:00), zona waktu tersebut digunakan. Jika tidak, zona waktu lokal lingkungan runtime digunakan untuk penguraian.

    Contoh: Cantumkan file atau objek yang berusia lebih dari 3 hari.

    ossutil ls oss://bucket/ --min-age 3d

    Filter berdasarkan ukuran file

    Filter berdasarkan ukuran file untuk mentransfer hanya file dalam rentang ukuran tertentu.

    Parameter konfigurasi:

    Parameter

    Deskripsi

    --min-size

    Melewatkan file yang lebih kecil dari ukuran ini. Satuan default: byte. Contoh: 1K (KiB) = 1024 byte.

    --max-size

    Melewatkan file yang lebih besar dari ukuran ini. Satuan default: byte. Contoh: 1K (KiB) = 1024 byte.

    Informasi tambahan:

    • Sufiks yang didukung: K (KiB) = 1024 byte, M (MiB), G (GiB), T (TiB), P (PiB), E (EiB).

    • Nilai desimal didukung, misalnya 0,5K.

    Contoh: Cantumkan file atau objek yang berukuran 1 MiB atau lebih kecil.

    ossutil ls oss://bucket/ --max-size 1M

    Filter berdasarkan aturan pencocokan metadata objek

    Filter metadata bekerja seperti filter path/nama file, tetapi hanya berlaku untuk objek bucket.

    Tentukan metadata dalam format `key=value` dengan pola glob untuk pencocokan.

    Opsi konfigurasi berikut didukung:

    • --metadata-include

    • --metadata-exclude

    • --metadata-filter

    • --metadata-filter-from

    Metadata objek berikut didukung:

    • Kelas penyimpanan: Gunakan `x-oss-storage-class=value`. Nilai yang valid untuk `value` adalah Standard, IA, Archive, ColdArchive, dan DeepColdArchive.

    • Tipe objek: Gunakan `x-oss-object-type=value`. Nilai yang valid untuk `value` adalah Normal, Multipart, Appendable, dan Symlink.

    • Status restore: Gunakan `x-oss-restore=value`. Atur `value` sesuai kebutuhan.

    • Content-Type: Gunakan `content-type=value`. Atur `value` sesuai kebutuhan.

    • Metadata yang ditentukan pengguna: Gunakan `x-oss-meta-aaa=value`, dengan `aaa` dalam huruf kecil. Atur `value` sesuai kebutuhan.

    Contoh: Cantumkan objek yang kelas penyimpanannya adalah Archive, ColdArchive, atau DeepColdArchive.

    ossutil ls oss://bucket/ --metadata-include "x-oss-storage-class=*Archive"