Object Storage Service：cp (unduh file)

Parameter

Tipe

Deskripsi

local-path

string

Jalur lokal. Jalur relatif, jalur mutlak, dan - didukung. Jika Anda menentukan -, keluaran dikirim ke standar output.

prefix

string

Awalan objek. Jika awalan diakhiri dengan garis miring (/), hanya operasi batch yang didukung. Jika awalan tidak diakhiri dengan garis miring (/), ossutil menentukan apakah akan melakukan pengunduhan objek tunggal atau pengunduhan batch berdasarkan opsi baris perintah.

--acl

string

Izin akses objek. Nilai yang valid:

• private: Objek bersifat privat.

• public-read: Objek bersifat baca-publik.

• public-read-write: Objek bersifat baca-tulis publik.

• default: Objek mewarisi ACL bucket.

--bandwidth-limit

SizeSuffix

Membatasi bandwidth jaringan untuk mengontrol laju transmisi data. Nilai minimum adalah 1.024 B/detik. Satuan default adalah B/detik.

Saat mengonfigurasi parameter ini, Anda dapat menentukan satuan untuk nilai bandwidth sesuai kebutuhan. Satuan opsional meliputi B (byte), K (kilobyte), M (megabyte), dan G (gigabyte). Misalnya, 50 M berarti bandwidth dibatasi hingga 50 MB/detik.

--bigfile-threshold

SizeSuffix

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

--cache-control

string

Menentukan perilaku caching halaman web saat objek diunduh.

--checkers

int

Jumlah pemeriksa yang berjalan secara paralel. Nilai default adalah 16.

--checkpoint-dir

string

Direktori yang menyimpan informasi checkpoint untuk operasi yang dapat dilanjutkan. Nilai default adalah .ossutil_checkpoint/.

--content-disposition

string

Menentukan cara objek ditampilkan.

--content-encoding

string

Menentukan format encoding objek.

--content-type

string

Tipe konten objek.

--copy-props

string

Mengontrol aturan penyalinan metadata dan tag. Nilai yang valid:

• none: Tidak menyalin metadata atau tag.

• metadata: Hanya menyalin metadata.

• default: Menyalin metadata dan tag.

-d, --dirs

string

Mengunduh file dan subdirektori dalam direktori saat ini, tetapi tidak mengunduh secara rekursif semua file di semua subdirektori.

--encoding-type

string

Tipe encoding nama objek atau nama file input. Nilai yang valid: url.

--end-with

string

Mengembalikan objek yang secara alfabetis berada sebelum atau sama dengan nilai yang ditentukan.

--exclude

stringArray

Aturan untuk mengecualikan jalur atau nama file.

--exclude-from

stringArray

Membaca aturan pengecualian dari file aturan.

--expires

string

Menentukan waktu kedaluwarsa absolut untuk konten yang di-cache.

--files-from

stringArray

Membaca daftar nama file sumber dari sebuah file. Baris kosong atau baris komentar diabaikan.

--files-from-raw

stringArray

Membaca daftar nama file sumber dari sebuah file.

--filter

stringArray

Aturan untuk memfilter jalur atau nama file.

--filter-from

stringArray

Membaca aturan pemfilteran dari file aturan.

-f, --force

/

Memaksa operasi tanpa prompt konfirmasi.

--include

stringArray

Aturan untuk menyertakan jalur atau nama file.

--include-from

stringArray

Membaca aturan penyertaan dari file aturan.

-j, --job

int

Jumlah tugas konkuren. Nilai default adalah 3.

--list-objects

/

Menggunakan operasi ListObjects untuk mencantumkan objek.

--max-size

SizeSuffix

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

--metadata

strings

Menentukan metadata pengguna objek dalam format key=value.

--metadata-directive

string

Menentukan cara mengatur metadata objek tujuan. Nilai yang valid:

• COPY

• REPLACE

--metadata-exclude

stringArray

Aturan untuk mengecualikan metadata objek.

--metadata-filter

stringArray

Aturan untuk memfilter metadata objek.

--metadata-filter-from

stringArray

Membaca aturan pemfilteran metadata objek dari file aturan.

--metadata-include

stringArray

Aturan untuk menyertakan metadata objek.

--min-age

Duration

Hanya mengunduh 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 mengunduh 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 mengunduh file yang dimodifikasi setelah waktu yang ditentukan. Waktu dalam UTC. Contoh: 2006-01-02T15:04:05.

--max-mtime

Time

Hanya mengunduh file yang dimodifikasi sebelum waktu yang ditentukan. Waktu dalam UTC. Contoh: 2006-01-02T15:04:05.

--min-size

SizeSuffix

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

--no-progress

/

Tidak menampilkan bilah kemajuan.

--page-size

int

Jumlah maksimum objek yang dicantumkan per halaman untuk pengunduhan batch. Nilai default adalah 1.000. Nilai berkisar antara 1 hingga 1.000.

--parallel

int

Jumlah tugas konkuren untuk operasi pada satu file.

--part-size

SizeSuffix

Ukuran bagian. Secara default, ossutil menghitung ukuran bagian yang sesuai berdasarkan ukuran file. Nilai berkisar antara 100 KiB hingga 5 GiB.

-r, --recursive

/

Menjalankan operasi secara rekursif. Jika Anda menentukan opsi ini, perintah dijalankan pada semua objek yang cocok dalam bucket. Jika tidak, perintah hanya dijalankan pada objek yang ditentukan oleh jalur tersebut.

--request-payer

string

Metode pembayaran untuk permintaan. Tetapkan parameter ini ke `requester` jika Anda menggunakan mode bayar-per-permintaan.

--size-only

/

Hanya mengunduh file sumber yang ukurannya berbeda dari file tujuan.

--start-after

string

Mengembalikan objek yang secara alfabetis berada setelah nilai yang ditentukan.

--storage-class

string

Kelas penyimpanan objek. Nilai yang valid:

• Standard: Standard

• IA stands for Infrequent Access storage class.

• Archive: Archive Storage

• ColdArchive: Cold Archive

• DeepColdArchive: Deep Cold Archive

--tagging

strings

Menentukan tag objek dalam format key=value.

--tagging-directive

string

Menentukan cara mengatur tag objek tujuan. Nilai yang valid:

• COPY

• REPLACE

-u, --update

/

Hanya mengunduh file sumber yang lebih baru daripada file tujuan.

--ignore-existing

/

Melewatkan file tujuan yang sudah ada.