Object Storage Service：Opsi tampilan, Opsi tampilan

Opsi

Deskripsi

-s, --short-format

Menampilkan item dalam format pendek. Jika Anda tidak menentukan opsi ini, format panjang digunakan.

--bigfile-threshold

Ambang ukuran objek untuk menggunakan unggahan yang dapat dilanjutkan. Nilai default: 104857600 (100 MB). Nilai valid: 0 hingga 9223372036854775807. Unit: byte.

--acl

Daftar kontrol akses (ACL).

--range

Rentang byte objek untuk diunduh. Byte dinomori mulai dari 0.

• Anda dapat menentukan rentang. Misalnya, 3-9 menentukan rentang dari byte 3 (inklusif) hingga byte 9 (inklusif).

• Anda dapat menentukan bidang dari mana unduhan dimulai. Misalnya, 3- menentukan rentang dari byte 3 (inklusif) hingga akhir objek (inklusif).

• Anda dapat menentukan bidang di mana unduhan berakhir. Misalnya, -9 menentukan rentang dari byte 0 (inklusif) hingga byte 9 (inklusif).

--all-versions

Menentukan semua versi objek.

--type

Algoritma yang digunakan untuk verifikasi data. Nilai valid:

• crc64 (default)

• md5

-v, --version

Menampilkan versi ossutil.

-u, --update

Menentukan operasi pembaruan.

--origin

Nilai header Origin dalam permintaan HTTP.

--upmode

Metode unggah yang digunakan dalam perintah probe. Nilai valid:

• normal (default): Objek diunggah menggunakan unggahan sederhana.

• append: Objek diunggah menggunakan unggahan tambahan.

• multipart: Objek diunggah menggunakan unggahan multipart.

--sse-algorithm

Metode enkripsi untuk bucket. Nilai valid:

• KMS: Kunci yang dikelola oleh Key Management Service (KMS) digunakan untuk enkripsi dan dekripsi (SSE-KMS).

• AES256: Kunci yang dikelola oleh OSS digunakan untuk enkripsi dan dekripsi (SSE-OSS).

--include

Menentukan bahwa objek yang memenuhi kondisi tertentu terdaftar. Misalnya, nilai *.jpg menentukan bahwa semua objek JPG di bucket terdaftar.

Untuk informasi lebih lanjut, lihat Opsi --include dan --exclude.

--exclude

Menentukan bahwa objek yang tidak memenuhi kondisi tertentu terdaftar. Misalnya, nilai *.txt menentukan bahwa semua objek TXT di bucket tidak terdaftar.

Untuk informasi lebih lanjut, lihat Opsi --include dan --exclude.

-r, --recursive

Menentukan operasi rekursif. Jika Anda mengonfigurasi opsi ini, operasi dilakukan pada semua objek yang sesuai dengan kondisi di bucket. Jika Anda tidak mengonfigurasi opsi ini, operasi hanya dilakukan pada objek yang ditentukan dalam URL.

--addr

Alamat jaringan yang konektivitasnya ingin Anda periksa. ossutil menjalankan perintah ping untuk memeriksa konektivitas jaringan antara komputer lokal Anda dan alamat yang ditentukan.

Nilai default: www.aliyun.com.

--kms-masterkey-id

ID kunci master pelanggan (CMK) yang digunakan untuk enkripsi di KMS.

--version-id

ID versi objek.

--version-id-marker

Posisi dari mana operasi daftar dimulai. Versi objek yang ID-nya secara alfabetis setelah nilai marker terdaftar. Anda hanya dapat mengonfigurasi opsi ini setelah penomoran versi diaktifkan untuk bucket.

-m, --multipart

Menentukan bahwa operasi dilakukan pada tugas unggahan multipart yang belum selesai di bucket.

-d, --directory

Menentukan bahwa hanya objek dan subdirektori di direktori saat ini yang dikembalikan.

--payer

Pembayar permintaan. Jika Anda menyetel opsi ini ke requester, mode bayar-per-permintaan diaktifkan.

--maxupspeed

Kecepatan unggah maksimum. Nilai default: 0 (tidak terbatas). Unit: KB/s.

--maxdownspeed

Kecepatan unduh maksimum. Nilai default: 0 (tidak terbatas). Unit: KB/s.

--retry-times

Jumlah percobaan ulang setelah terjadi kesalahan saat perintah dijalankan. Nilai default: 10. Nilai valid: 1 hingga 500.

--download

Menentukan bahwa ossutil memeriksa konektivitas jaringan antara komputer lokal Anda dan bucket dengan menggunakan URL objek untuk mengunduh objek dari bucket.

-j, --jobs

Jumlah tugas konkuren yang dapat dilakukan di beberapa objek. Nilai valid: 1 hingga 10000. Nilai default: 3.

-a, --all-type

Menentukan bahwa operasi dilakukan pada objek dan tugas unggahan multipart yang belum selesai di bucket.

--disable-empty-referer

Menentukan bahwa bidang Referer tidak boleh kosong.

--method

Metode permintaan HTTP. Nilai valid: PUT, GET, dan DELETE.

--output-dir

Menentukan direktori tempat objek keluaran berada. Objek keluaran mencakup objek laporan yang dihasilkan karena kesalahan yang terjadi saat Anda menjalankan perintah cp untuk menyalin beberapa objek secara bersamaan.

Secara default, direktori untuk objek keluaran adalah ossutil_output di direktori saat ini.

--meta

Menentukan metadata objek dalam format [header:nilai#header:nilai...]. Contoh: Cache-Control:no-cache#Content-Encoding:gzip.

--object

Nama objek dalam perintah probe.

--end-time

Timestamp dalam Linux atau UNIX. Objek yang waktu modifikasi terakhirnya lebih baru dari timestamp diabaikan.

--limited-num

Jumlah maksimum hasil yang akan dikembalikan.

-L, --language

Bahasa yang digunakan oleh ossutil. Nilai default: CH. Nilai valid:

• CH: Cina. Jika Anda ingin menyetel opsi ini ke CH, pastikan sistem Anda mendukung pengkodean UTF-8.

• EN: Inggris.

--delete

Menghapus bucket, objek, atau bagian.

-b, --bucket

Menentukan bahwa perintah dijalankan untuk menghapus bucket. Opsi ini hanya berlaku saat Anda menghapus bucket.

--disable-crc64

Menonaktifkan CRC-64 dalam transmisi data. Secara default, CRC-64 diaktifkan saat Anda menggunakan ossutil untuk mentransfer data.

--upload

Memeriksa konektivitas jaringan antara komputer lokal Anda dan bucket dengan mengunggah file lokal ke bucket.

--part-size

Ukuran bagian dalam byte. Secara default, ossutil menghitung ukuran bagian yang sesuai berdasarkan ukuran objek. Anda dapat mengonfigurasi opsi ini untuk mengoptimalkan kinerja atau memenuhi persyaratan khusus. Nilai valid: 1 hingga 9223372036854775807.

--timeout

Periode timeout untuk URL yang ditandatangani. Nilai valid: 0 hingga 9223372036854775807. Nilai default: 60. Unit: detik.

--checkpoint-dir

Direktori tempat informasi titik pemeriksaan tugas unggah, unduhan, atau salinan yang dapat dilanjutkan disimpan. Jika tugas gagal, ossutil secara otomatis membuat direktori bernama .ossutil_checkpoint dan menyimpan informasi titik pemeriksaan di direktori tersebut. Jika tugas berhasil, ossutil menghapus direktori tersebut. Jika Anda menentukan direktori titik pemeriksaan, pastikan direktori tersebut dapat dihapus.

--url

URL objek.

--marker

Posisi dari mana operasi daftar dimulai. Bucket, objek, atau bagian yang namanya secara alfabetis setelah marker terdaftar.

-f, --force

Menentukan bahwa operasi dilakukan secara paksa tanpa konfirmasi.

--snapshot-path

Direktori tempat Anda ingin menyimpan snapshot objek yang diunggah dan diunduh. Jika Anda mengonfigurasi opsi ini, ossutil membaca informasi snapshot dari direktori yang ditentukan dan melakukan unggahan atau unduhan inkremental saat objek diunggah atau diunduh.

• Opsi --snapshot-path digunakan untuk mempercepat unggahan atau unduhan inkremental beberapa objek. Opsi ini tidak dapat digunakan untuk menyalin objek. Opsi ini dapat digunakan saat sejumlah besar objek diunggah dan tidak ada pengguna lain yang memodifikasi objek di OSS di antara dua unggahan.

• Opsi --snapshot-path mencatat waktu modifikasi terakhir objek yang diunggah atau diunduh di komputer lokal Anda. Kemudian, waktu yang dicatat digunakan untuk menentukan objek mana yang dapat dilewati lain kali objek tersebut diunggah atau diunduh. Oleh karena itu, saat menggunakan opsi ini, pastikan objek yang terlibat di OSS tidak dimodifikasi di antara dua unggahan atau unduhan. Dalam skenario lain di mana objek diperbarui di OSS di antara dua unggahan atau unduhan, gunakan opsi --update untuk melakukan unggahan atau unduhan inkremental beberapa objek secara bersamaan.

• ossutil tidak secara otomatis menghapus informasi snapshot dari direktori yang ditentukan oleh snapshot-path. Anda dapat menghapus informasi snapshot yang tidak lagi digunakan.

• Overhead tambahan diperlukan untuk membaca dan menulis informasi snapshot. Kami merekomendasikan agar Anda tidak menggunakan opsi ini dalam skenario di mana jumlah objek yang akan diunggah atau diunduh sedikit, kondisi jaringan baik, atau pengguna lain perlu melakukan operasi pada objek. Dalam skenario ini, Anda dapat menggunakan opsi --update sebagai gantinya untuk melakukan unggahan atau unduhan inkremental.

• Anda dapat mengonfigurasi opsi --update dan --snapshot-path dalam satu perintah. ossutil menentukan apakah akan melewati objek dalam tugas unggahan atau unduhan berdasarkan snapshot yang disimpan di direktori yang ditentukan oleh opsi --snapshot-path. Jika tidak ada snapshot yang dihasilkan untuk objek, ossutil menentukan apakah akan melewati objek berdasarkan opsi --update.

--start-time

Menentukan timestamp dalam Linux atau UNIX. Jika Anda mengonfigurasi opsi ini, objek yang waktu modifikasi terakhirnya lebih lama dari timestamp diabaikan.

--storage-class

Kelas penyimpanan objek. Nilai valid:

• Standard (default): Kelas penyimpanan ini cocok untuk objek yang sering diakses.

• IA: Kelas penyimpanan ini cocok untuk data yang jarang diakses, seperti data yang diakses sekali atau dua kali sebulan. Objek Infrequent Access (IA) memiliki periode penyimpanan minimum 30 hari dan ukuran tagihan minimum 64 KB. Anda dapat mengakses objek IA secara real-time. Anda dikenakan biaya pengambilan data saat mengakses objek IA.

• Archive: Kelas penyimpanan ini cocok untuk data yang perlu disimpan untuk jangka waktu panjang. Objek Arsip memiliki periode penyimpanan minimum 60 hari dan ukuran tagihan minimum 64 KB. Anda harus memulihkan objek Arsip sebelum dapat mengakses objek tersebut. Pemulihan memakan waktu sekitar 1 menit. Anda dikenakan biaya pengambilan data saat memulihkan objek Arsip.

• ColdArchive: Kelas penyimpanan ini cocok untuk penyimpanan jangka panjang data yang hampir tidak pernah diakses. Objek Cold Archive memiliki periode penyimpanan minimum 180 hari dan ukuran tagihan minimum 64 KB. Anda harus memulihkan objek Cold Archive sebelum dapat mengakses objek tersebut. Waktu yang diperlukan untuk memulihkan objek Cold Archive bervariasi berdasarkan ukuran objek dan mode pemulihan. Anda dikenakan biaya pengambilan data saat memulihkan objek Cold Archive.

-t, --sts-token

Menentukan token STS yang digunakan untuk mengakses OSS. Opsi ini hanya diperlukan saat Anda menggunakan STS untuk mengizinkan akses sementara ke OSS. Nilai opsi ini menimpa konfigurasi dalam file konfigurasi. Untuk informasi lebih lanjut tentang cara menghasilkan token STS, lihat Pengunggahan pihak ketiga yang berizin.

--parallel

Jumlah operasi konkuren yang dilakukan pada satu objek. Nilai valid: 1 hingga 10000. Secara default, ossutil secara otomatis menetapkan nilai untuk opsi ini berdasarkan jenis operasi dan ukuran objek.

--partition-download

Partisi yang ingin Anda unduh. Nilai opsi ini dalam format nomor partisi:total jumlah partisi. Misalnya, nilai 1:5 menentukan bahwa objek dibagi menjadi lima partisi dan bahwa perintah saat ini mengunduh partisi 1. Partisi dinomori mulai dari 1. Aturan partisi untuk objek ditentukan oleh ossutil berdasarkan algoritma internal. Opsi ini membagi objek menjadi beberapa partisi yang dapat diunduh secara bersamaan oleh beberapa perintah ossutil. Setiap perintah ossutil mengunduh partisinya sendiri.

--bucketname

Nama bucket.

--encoding-type

Tipe pengkodean yang ingin Anda gunakan untuk mengkodekan kunci yang mengikuti oss://bucket_name. Nilai valid: url. Jika Anda tidak mengonfigurasi opsi ini, kunci tidak dikodekan.

--origin

Nilai header Origin dalam permintaan HTTP. Nilai opsi ini menentukan domain asal dari mana permintaan lintas asal dikirim.

--acr-method

Nilai header Access-Control-Request-Method dalam permintaan HTTP. Nilai valid: GET, PUT, POST, DELETE, dan HEAD.

--acr-headers

Nilai header Access-Control-Request-Headers dalam permintaan HTTP. Nilai opsi ini menentukan header yang perlu Anda tambahkan ke permintaan. Header tidak termasuk header permintaan umum. Untuk menentukan beberapa header, pisahkan header dengan koma (,) dan tutup header dengan tanda kutip ganda (" "). Contoh: --acr-headers "header1,header2,header3".

--upload-id-marker

Posisi dari mana operasi daftar dimulai. Bagian yang ID unggahannya secara alfabetis setelah marker terdaftar.

-h, --help

Menampilkan informasi bantuan untuk perintah tertentu.

--trafic-limit

Kecepatan akses melalui HTTP dalam perintah sign. Unit: bit/s.

Nilai default: 0. Nilai 0 menentukan bahwa kecepatan akses tidak terbatas.

Nilai valid: 819200 hingga 838860800 (100 KB/s hingga 100 MB/s).

--local-host

Alamat IP lokal ossutil dalam perintah cp. Setelah Anda mengonfigurasi opsi ini, ossutil mengakses OSS menggunakan alamat IP yang ditentukan.

--enable-symlink-dir

Subdirektori yang ditunjuk oleh tautan simbolik diunggah. Secara default, subdirektori tidak diunggah. Perintah probe dapat digunakan untuk memeriksa apakah objek atau direktori yang ditunjuk oleh tautan simbolik juga merupakan tautan simbolik.

--only-current-dir

Menentukan bahwa hanya objek di direktori saat ini yang diunggah, diunduh, atau disalin. Subdirektori dan objek di subdirektori di direktori saat ini diabaikan.

--disable-dir-object

Menentukan bahwa tidak ada objek OSS yang dihasilkan untuk direktori yang diunggah, tetapi direktori dipertahankan dalam struktur direktori di konsol OSS. Jika Anda menghapus semua objek di direktori, direktori juga dihapus.

--probe-item

Item yang akan diperiksa menggunakan perintah probe. Nilai valid:

• upload-speed: ossutil memeriksa bandwidth unggah.

• download-speed: ossutil memeriksa bandwidth unduhan.

• cycle-symlink: ossutil memeriksa apakah tautan simbolik di direktori file lokal menunjuk ke dirinya sendiri.

--redundancy-type

Tipe redundansi bucket. Nilai valid:

• LRS (default): Jika Anda menyetel tipe redundansi bucket ke penyimpanan redundan lokal (LRS), OSS menyimpan salinan setiap objek di perangkat yang berbeda dalam zona yang sama. Dengan cara ini, OSS memastikan keandalan dan ketersediaan data bahkan jika dua perangkat penyimpanan rusak pada saat yang sama.

• ZRS: Jika Anda menyetel tipe redundansi bucket ke penyimpanan redundan zona (ZRS), OSS menyimpan beberapa salinan data Anda di beberapa zona di wilayah yang sama. Data Anda masih dapat diakses meskipun suatu zona menjadi tidak tersedia.

--disable-encode-slash

Menentukan bahwa garis miring (/) di URL tidak dikodekan.

--disable-all-symlink

Menentukan bahwa semua objek di subdirektori yang ditunjuk oleh tautan simbolik dan subdirektori yang ditunjuk oleh tautan simbolik diabaikan selama pengunggahan objek.

--tagging

Tag objek saat Anda mengunggah atau menyalin objek. Contoh: "abc=1&bcd=2&……".

--disable-ignore-error

Kesalahan memunculkan pengecualian, yang menghentikan perintah. Menentukan bahwa kesalahan tidak diabaikan untuk operasi batch.

--block-size

Satuan ukuran total objek yang diperoleh dalam bucket atau direktori yang ditentukan. Nilai valid: KB, MB, GB, dan TB. Jika Anda tidak mengonfigurasi opsi ini, ukuran total objek yang diperoleh diukur dalam byte secara default.