Object Storage Service：Perintah lanjutan

Ruang Lingkup Perintah

Opsi yang Didukung

Semua perintah lanjutan

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

• --request-payer string: Metode pembayaran untuk permintaan. Jika Anda menggunakan mode pay-by-requester, atur parameter ini ke `requester`.

Perintah yang mendukung operasi batch

• --start-after/--end-with (, ]: Menentukan rentang kueri kunci. Rentang ini eksklusif terhadap nilai awal dan inklusif terhadap nilai akhir.

• Opsi filter: Anda dapat mengatur kondisi filter berdasarkan informasi seperti nama objek/file, folder objek/file, ukuran objek/file, waktu objek/file, dan metadata objek. Untuk informasi lebih lanjut tentang aturan penyaringan spesifik, lihat Opsi filter.

• --limited-num: Mengatur data yang dikembalikan oleh API kueri.

• --recursive/-r: Melakukan operasi rekursif. Mengakses semua file atau objek di direktori root secara rekursif, termasuk subdirektori.

• --dirs/-d: Hanya mengakses file atau objek di direktori root, tidak termasuk subdirektori.

  Catatan

  Untuk objek, hal ini diimplementasikan menggunakan metode Delimiter. Ini memerlukan pemindaian semua objek di bawah awalan tersebut. Semakin banyak objek, semakin lama operasi ini berlangsung.

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

• --list-objects: Menggunakan API ListObjects untuk menampilkan daftar objek.

Perintah yang mendukung aturan penyaringan tujuan

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

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

• --checksum: Membandingkan checksum CRC-64. Ukuran file dibandingkan terlebih dahulu. Jika ukuran file sama, checksum CRC-64 kemudian dibandingkan. Jika checksum CRC-64 tidak ada di salah satu sisi, file dianggap tidak konsisten. Ini hanya berlaku untuk penyalinan antar objek.

• --ignore-existing: Melewati 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

Tipe opsi

Deskripsi

--encoding-type

string

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

--request-payer

string

Metode pembayaran untuk permintaan. Jika Anda menggunakan mode pay-by-requester, atur parameter ini. Nilai yang valid: requester.

--start-after

string

Mengembalikan objek yang secara alfabetis berada setelah nilai yang ditentukan. Objek yang ditentukan tidak disertakan.

--end-with

string

Mengembalikan objek yang secara alfabetis berada sebelum nilai yang ditentukan. Objek yang ditentukan disertakan.

--page-size

int

Jumlah maksimum objek yang ditampilkan per halaman selama Pemrosesan batch. Nilai default: 1000. Rentang nilai: 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 penyaringan file.

--files-from-raw

stringArray

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

--max-age

Duration

Tidak mentransfer file apa pun yang lebih tua dari usia ini. Satuan default adalah detik. Anda juga dapat menggunakan akhiran satuan, seperti ms, s, m, h, d, w, M, atau y. Nilai default: off.

--min-age

Duration

Tidak mentransfer file apa pun yang lebih baru dari usia ini. Satuan default adalah detik. Anda juga dapat menggunakan akhiran satuan, seperti ms, s, m, h, d, w, M, atau y. Nilai default: off.

--max-mtime

Time

Tidak mentransfer file apa pun yang lebih baru dari waktu ini. Gunakan format UTC. Nilai default: off.

--min-mtime

Time

Tidak mentransfer file apa pun yang lebih tua dari waktu ini. Gunakan format UTC. Nilai default: off.

--max-size

SizeSuffix

Ukuran maksimum file yang akan ditransfer. Satuan default adalah byte. Anda juga dapat menggunakan akhiran satuan, seperti B, K, M, G, T, atau P. 1 K (KiB) = 1024 B.

--min-size

SizeSuffix

Ukuran minimum file yang akan ditransfer. Satuan default adalah byte. Anda juga dapat menggunakan akhiran satuan, seperti B, K, M, G, T, atau P. 1 K (KiB) = 1024 B.

--metadata-exclude

stringArray

Aturan pengecualian 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

/

Menjalankan operasi rekursif. Ketika opsi ini ditentukan, perintah dijalankan pada semua objek dalam bucket yang memenuhi kondisi. Jika tidak, perintah hanya dijalankan pada objek yang ditentukan oleh path.

-d, --dirs

/

Menampilkan file dan subdirektori dalam folder saat ini, bukan menampilkan semua file di semua subdirektori secara rekursif.

-f, --force

/

Memaksa operasi tanpa prompt konfirmasi.

--list-objects

/

Menggunakan API ListObjects untuk menampilkan daftar objek.

--no-progress

/

Tidak menampilkan bilah progres.

-j, --job

int

Jumlah tugas konkuren untuk operasi multi-file. Nilai default: 3.

--checkers

int

Jumlah checker yang dijalankan secara paralel. Nilai default: 16.

--parallel

int

Jumlah tugas konkuren untuk operasi dalam satu file.

--part-size

SizeSuffix

Ukuran bagian. Secara default, ukuran bagian yang sesuai dihitung berdasarkan ukuran file. Rentang nilai: 100 KiB hingga 5 GiB.

--bigfile-threshold

int

Ambang batas untuk mengaktifkan unggah multi-bagian, unduh, atau salin untuk file besar. Nilai default: 104857600.

--version-id

string

ID versi objek.

--storage-class

string

Kelas penyimpanan objek. Nilai 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

Menentukan perilaku caching halaman web saat objek diunduh.

--content-disposition

string

Menentukan format tampilan objek.

--content-encoding

string

Mendeklarasikan kodek objek.

--content-type

string

Tipe konten objek.

--expires

string

Menentukan waktu kedaluwarsa absolut untuk konten yang di-cache.

--copy-props

string

Menentukan properti mana yang akan disalin dari objek sumber. Nilai yang valid: none, metadata, dan default.

--tagging

string

Menentukan tag objek dalam format key=value.

--tagging-directive

string

Menentukan cara mengatur tag objek tujuan. Nilai yang valid: COPY dan REPLACE.

--metadata

string

Menentukan metadata pengguna objek dalam format key=value.

--metadata-directive

string

Menentukan cara mengatur metadata objek tujuan. Nilai yang valid: COPY dan 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.

Item

Deskripsi

Sintaks aturan filter

• pola aturan opsi aturan parameter: Pola pencocokan Glob.

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

• pengubah aturan pola aturan opsi aturan parameter: 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

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 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
 - **

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 di 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 di awal atau akhir dan baris komentar yang dimulai dengan # atau ; tidak diabaikan.

Parameter

Deskripsi

--min-age

Duration

Hanya memproses file yang dimodifikasi sebelum interval waktu yang ditentukan. Satuan default adalah detik. Anda dapat menggunakan akhiran satuan. Misalnya, 1h berarti 1 jam.

--max-age

Duration

Hanya memproses file yang dimodifikasi dalam interval waktu yang ditentukan. Satuan default adalah detik. Anda dapat menggunakan akhiran satuan. Misalnya, 1h berarti 1 jam.

--min-mtime

Time

Hanya memproses file yang dimodifikasi setelah waktu yang ditentukan. Format waktu adalah UTC. Misalnya, 2006-01-02T15:04:05.

--max-mtime

Time

Hanya memproses file yang dimodifikasi sebelum waktu yang ditentukan. Format waktu adalah UTC. Misalnya, 2006-01-02T15:04:05.

Parameter

Deskripsi

--min-size

Tidak mentransfer file apa pun yang lebih kecil dari ukuran ini. Satuan default adalah byte (B). Anda juga dapat menggunakan akhiran satuan. Misalnya, 1K (KiB) merepresentasikan 1024 byte.

--max-size

Tidak mentransfer file apa pun yang lebih besar dari ukuran ini. Satuan default adalah byte (B). Anda juga dapat menggunakan akhiran satuan. Misalnya, 1K (KiB) merepresentasikan 1024 byte.