Object Storage Service:Perintah Lanjutan

Cakupan perintah

Opsi yang didukung

Semua perintah lanjutan

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

• --request-payer string: Metode pembayaran untuk permintaan. Atur opsi ini ke requester jika Anda menggunakan mode pay-by-requester.

Perintah yang mendukung operasi batch

• --start-after/--end-with (, ]: Interval terbuka di kiri dan tertutup di kanan. Gunakan opsi ini untuk menentukan rentang kunci dalam kueri.

• Opsi filter: Anda dapat menetapkan kondisi filter untuk objek atau file berdasarkan nama, direktori, ukuran, waktu modifikasi, atau metadata. Untuk informasi lebih lanjut tentang aturan filter, lihat Opsi Filter.

• --limited-num: Menentukan jumlah item yang dikembalikan oleh API kueri.

• --recursive/-r: Melakukan operasi secara rekursif. Opsi ini memungkinkan Anda mengakses semua file atau objek di bawah direktori root, termasuk subdirektori.

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

  Catatan

  Untuk objek, OSS mensimulasikan direktori menggunakan parameter delimiter. Hal ini memerlukan pemindaian semua objek di bawah awalan yang ditentukan. Semakin banyak objek, semakin lama waktu pemindaian.

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

• --list-objects: Menampilkan daftar objek menggunakan API ListObjects.

Perintah yang mendukung aturan filter tujuan

• --update: Melewatkan file tujuan yang lebih baru daripada file sumber, tetapi memperbarui file yang memiliki waktu modifikasi sama dengan file sumber.

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

• --checksum: Membandingkan checksum CRC64. OSS pertama-tama membandingkan ukuran file. Jika ukuran cocok, nilai CRC64 dibandingkan. Jika CRC64 tidak tersedia di salah satu sisi, OSS menganggap file tersebut tidak konsisten. Opsi ini hanya berlaku untuk operasi copy objek-ke-objek.

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

Perintah yang mendukung operasi 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. Atur opsi ini ketika format file daftar adalah inventory.

Opsi lokal

Tipe

Deskripsi

--encoding-type

string

Metode encoding untuk nama objek atau nama file. Nilai yang valid: url.

--request-payer

string

Metode pembayaran untuk permintaan. Atur opsi ini ke requester jika Anda menggunakan mode pay-by-requester. Nilai yang valid: requester.

--start-after

string

Mengembalikan objek yang muncul setelah nilai yang ditentukan dalam urutan alfabetis. Nilai yang ditentukan itu sendiri tidak disertakan.

--end-with

string

Mengembalikan objek yang muncul sebelum nilai yang ditentukan dalam urutan alfabetis. Nilai yang ditentukan itu sendiri disertakan.

--page-size

int

Jumlah maksimum objek yang ditampilkan per halaman selama pemrosesan batch. Nilai default: 1000. Nilai yang valid: 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 dan baris komentar yang diawali dengan # atau ; diabaikan. Opsi ini hanya berlaku untuk operasi filter file.

--files-from-raw

stringArray

Membaca daftar nama file sumber dari sebuah file. Opsi ini hanya berlaku untuk operasi filter file.

--max-age

Duration

Tidak mentransfer file apa pun yang dimodifikasi lebih awal dari waktu yang ditentukan. Satuan default: detik. Sufiks yang didukung: ms, s, m, h, d, w, M, y. Nilai default: off.

--min-age

Duration

Tidak mentransfer file apa pun yang dimodifikasi lebih baru dari waktu yang ditentukan. Satuan default: detik. Sufiks yang didukung: ms, s, m, h, d, w, M, y. Nilai default: off.

--max-mtime

Time

Tidak mentransfer file apa pun yang dimodifikasi lebih baru dari waktu yang ditentukan. Format waktu: UTC. Nilai default: off.

--min-mtime

Time

Tidak mentransfer file apa pun yang dimodifikasi lebih awal dari waktu yang ditentukan. Format waktu: UTC. Nilai default: off.

--max-size

SizeSuffix

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

--min-size

SizeSuffix

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

--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 atau checksum-nya (jika tersedia) berbeda dari file tujuan.

--size-only

/

Hanya menyalin file sumber yang ukurannya berbeda dari file tujuan.

-u, --update

/

Melewatkan file yang sudah ada di tujuan dan memiliki waktu modifikasi lebih baru daripada file sumber.

-r, --recursive

/

Menjalankan operasi rekursif. Ketika Anda menentukan opsi ini, perintah beroperasi pada semua objek yang sesuai dengan kondisi di bucket. Jika tidak, perintah hanya beroperasi pada objek di path yang ditentukan.

-d, --dirs

/

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

-f, --force

/

Memaksa operasi tanpa meminta konfirmasi.

--list-objects

/

Menampilkan daftar objek menggunakan API ListObjects.

--no-progress

/

Menyembunyikan bilah kemajuan.

-j, --job

int

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

--checkers

int

Jumlah checker konkuren. Nilai default: 16.

--parallel

int

Jumlah tugas konkuren untuk operasi internal pada satu file.

--part-size

SizeSuffix

Ukuran bagian untuk unggah multi-bagian. Secara default, ossutil menghitung ukuran bagian yang sesuai berdasarkan ukuran file. Nilai yang valid: 100 KiB hingga 5 GiB.

--bigfile-threshold

int

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

--version-id

string

ID versi objek.

--storage-class

string

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

--acl

string

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

--cache-control

string

Menentukan perilaku cache untuk objek saat diunduh.

--content-disposition

string

Menentukan cara objek ditampilkan.

--content-encoding

string

Menyatakan metode encoding untuk 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, default.

--tagging

string

Menentukan tag untuk objek dalam format key=value.

--tagging-directive

string

Menentukan cara menetapkan tag untuk objek tujuan. Nilai yang valid: COPY, REPLACE.

--metadata

string

Menentukan metadata yang ditentukan pengguna untuk objek dalam format key=value.

--metadata-directive

string

Menentukan cara menetapkan metadata untuk 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. Atur opsi ini ketika format file daftar adalah inventory.

Item

Deskripsi

Sintaks aturan filter

• pola aturan: Pencocokan pola glob.

• nama file aturan: Path ke file aturan yang menggunakan pencocokan pola glob.

• pengubah aturan pola: Instruksi untuk pencocokan pola glob. + berarti sertakan. Objek yang cocok dengan aturan disertakan dalam hasil. - berarti kecualikan. Objek yang cocok dengan aturan dikecualikan dari hasil.

Parameter aturan filter

• --include

• --include-from

• --exclude

• --exclude-from

• --filter

• --filter-from

Opsi

Deskripsi

--include

--exclude

Setiap opsi mengambil pola langsung sebagai argumen. Setiap opsi mendefinisikan satu aturan. Untuk menggunakan beberapa aturan, ulangi opsi tersebut.

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

Perintah berikut mengunduh file secara rekursif yang sesuai dengan aturan filter dari direktori oss://examplebucket/exampledir/ di Alibaba Cloud OSS ke direktori lokal 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

Setiap opsi mengambil instruksi dan pola sebagai argumen. Setiap opsi mendefinisikan satu aturan. Untuk menggunakan beberapa aturan, ulangi opsi tersebut.

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

• Simbol + berarti sertakan. Objek yang cocok dengan aturan disertakan dalam hasil.

• Simbol - berarti kecualikan. Objek yang cocok dengan aturan dikecualikan dari hasil.

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

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

--include-from

--exclude-from

Setiap opsi mengambil path ke file aturan sebagai argumen. Setiap baris dalam file aturan adalah pola glob. Untuk menggunakan beberapa file aturan, ulangi opsi tersebut.

Aturan yang dibaca dengan --include-from adalah aturan inklusi. Aturan yang dibaca dengan --exclude-from adalah aturan eksklusi.

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

File aturan include-file.txt berisi:

 *.txt
 *.js

File aturan include-file.txt berisi konten berikut:

 *.jpg

--filter-from

Setiap opsi mengambil path ke file aturan sebagai argumen. Setiap baris dalam file aturan adalah instruksi dan pola glob.

Untuk menggunakan beberapa file aturan, ulangi opsi tersebut.

Contoh: --filter-from filter-file.txt. File aturan filter-file.txt berisi:

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

Opsi

Deskripsi

--files-from

Membaca daftar path atau nama file dari sebuah file. Untuk menggunakan beberapa file daftar, ulangi opsi tersebut.

Saat memproses setiap baris dalam file daftar, OSS menghapus spasi di awal dan akhir serta mengabaikan baris komentar yang diawali dengan # atau ;.

--files-from-raw

Membaca daftar path atau nama file dari sebuah file. Untuk menggunakan beberapa file daftar, ulangi opsi tersebut.

Saat memproses setiap baris dalam file daftar, OSS tidak menghapus spasi di awal atau akhir dan tidak mengabaikan baris komentar yang diawali dengan # atau ;.

Parameter

Deskripsi

--min-age

Duration

Hanya memproses file yang dimodifikasi sebelum interval waktu yang ditentukan. Satuan default: detik. Sufiks yang didukung: ms, s, m, h, d, w, M, y. Contoh: 1h berarti 1 jam.

--max-age

Duration

Hanya memproses file yang dimodifikasi dalam interval waktu yang ditentukan. Satuan default: detik. Sufiks yang didukung: ms, s, m, h, d, w, M, y. Contoh: 1h berarti 1 jam.

--min-mtime

Time

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

--max-mtime

Time

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

Parameter

Deskripsi

--min-size

Tidak mentransfer file apa pun yang lebih kecil dari ukuran yang ditentukan. Satuan default: byte (B). Sufiks yang didukung: K (KiB), M (MiB), G (GiB), T (TiB), P (PiB), E (EiB). Contoh: 1K berarti 1024 byte.

--max-size

Tidak mentransfer file apa pun yang lebih besar dari ukuran yang ditentukan. Satuan default: byte (B). Sufiks yang didukung: K (KiB), M (MiB), G (GiB), T (TiB), P (PiB), E (EiB). Contoh: 1K berarti 1024 byte.