Object Storage Service:cp (unduh file)

Parameter

Jenis

Deskripsi

local-path

string

Mendukung jalur relatif, jalur mutlak, dan -. Jika diatur ke -, output akan dikirim ke standard output.

prefix

string

Awalan objek. Jika awalan diakhiri dengan "/", hanya operasi batch yang didukung. Jika tidak diakhiri dengan "/", perintah menentukan apakah akan melakukan unduhan objek tunggal atau unduhan batch berdasarkan opsi baris perintah.

--acl

string

Izin akses untuk objek. Nilai yang valid:

• private: private.

• public-read: baca-publik.

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

• default: mewarisi dari bucket.

--bandwidth-limit

SizeSuffix

Membatasi bandwidth jaringan untuk mengontrol laju transfer data. Nilai minimum adalah 1024 B/s. Satuan default adalah B/s.

Anda dapat menentukan satuan untuk nilai bandwidth. Satuan yang didukung meliputi B (byte), K (kilobyte), M (megabyte), dan G (gigabyte). Misalnya, 50 M menetapkan batas menjadi 50 MB/s.

--bigfile-threshold

SizeSuffix

Ambang batas untuk mengaktifkan unggah multi-bagian, unduh, atau copy untuk file besar (default: 104857600).

--cache-control

string

Menentukan perilaku cache saat objek diunduh oleh browser web.

--checkers

int

Jumlah checker konkuren (default: 16).

--checkpoint-dir

string

Direktori untuk menyimpan informasi checkpoint unduhan yang dapat dilanjutkan (default: .ossutil_checkpoint/).

--content-disposition

string

Menentukan cara objek ditampilkan.

--content-encoding

string

Menyatakan metode encoding objek.

--content-type

string

Tipe konten objek.

--copy-props

string

Mengontrol cara metadata dan tag disalin. Nilai yang valid:

• none: jangan salin.

• metadata: salin metadata.

• default: salin metadata dan tag.

-d, --dirs

string

Unduh file dan subdirektori di direktori saat ini tanpa mengunduh semua file secara rekursif di subdirektori bersarang.

--encoding-type

string

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

--end-with

string

Mengembalikan objek yang berada sebelum atau sesuai dengan nilai yang ditentukan dalam urutan alfabetis.

--exclude

stringArray

Aturan pengecualian untuk jalur atau nama file.

--exclude-from

stringArray

Baca aturan pengecualian dari file.

--expires

string

Menentukan waktu kedaluwarsa absolut untuk konten yang di-cache.

--files-from

stringArray

Baca daftar nama file sumber dari file, mengabaikan baris kosong atau komentar. Hanya berlaku untuk skenario penyaringan.

--files-from-raw

stringArray

Baca daftar nama file sumber dari file. Hanya berlaku untuk skenario penyaringan.

--filter

stringArray

Aturan penyaringan untuk jalur atau nama file.

--filter-from

stringArray

Baca aturan penyaringan dari file.

-f, --force

/

Paksa operasi tanpa meminta konfirmasi.

--include

stringArray

Aturan penyertaan untuk jalur atau nama file.

--include-from

stringArray

Baca aturan penyertaan dari file.

-j, --job

int

Jumlah tugas konkuren (default: 3).

--list-objects

/

Gunakan API ListObjects untuk mencantumkan objek.

--max-size

SizeSuffix

Ukuran file maksimum untuk ditransfer. Satuan default adalah byte. Anda dapat menambahkan sufiks: B|K|M|G|T|P. Catatan: 1K (KiB) = 1024B.

--metadata

strings

Metadata yang ditentukan pengguna untuk objek, dalam format key=value.

--metadata-directive

string

Menentukan cara mengatur metadata untuk objek tujuan. Nilai yang valid:

• COPY

• REPLACE

--metadata-exclude

stringArray

Aturan pengecualian untuk metadata objek.

--metadata-filter

stringArray

Aturan penyaringan untuk metadata objek.

--metadata-filter-from

stringArray

Baca aturan penyaringan metadata objek dari file.

--metadata-include

stringArray

Aturan penyertaan untuk metadata objek.

--min-age

Duration

Unduh hanya file yang dimodifikasi sebelum interval waktu yang ditentukan. Satuan default adalah detik. Anda dapat menggunakan sufiks seperti h (jam). Misalnya, 1h berarti 1 jam.

--max-age

Duration

Unduh hanya file yang dimodifikasi dalam interval waktu yang ditentukan. Satuan default adalah detik. Anda dapat menggunakan sufiks seperti h (jam). Misalnya, 1h berarti 1 jam.

--min-mtime

Time

Unduh hanya file yang dimodifikasi setelah waktu yang ditentukan. Format waktu: UTC, misalnya, 2006-01-02T15:04:05.

--max-mtime

Time

Unduh hanya file yang dimodifikasi sebelum waktu yang ditentukan. Format waktu: UTC, misalnya, 2006-01-02T15:04:05.

--min-size

SizeSuffix

Ukuran file minimum untuk ditransfer. Satuan default adalah byte. Anda dapat menambahkan sufiks: B|K|M|G|T|P. Catatan: 1K (KiB) = 1024B.

--no-progress

/

Jangan tampilkan bilah progres.

--page-size

int

Jumlah maksimum objek yang dicantumkan per halaman selama unduhan batch (default: 1000). Rentang valid: 1–1000.

--parallel

int

Jumlah tugas konkuren untuk operasi internal pada satu file.

--part-size

SizeSuffix

Ukuran bagian untuk operasi multi-bagian. Secara default, ossutil menghitung ukuran bagian yang sesuai berdasarkan ukuran file. Rentang valid: 100 KiB–5 GiB.

-r, --recursive

/

Lakukan operasi secara rekursif. Saat opsi ini ditentukan, perintah beroperasi pada semua objek yang cocok di bucket. Jika tidak, perintah hanya beroperasi pada objek yang ditentukan oleh jalur tersebut.

--request-payer

string

Metode pembayaran untuk permintaan. Atur ke requester jika bucket menggunakan mode bayar-per-permintaan.

--size-only

/

Unduh hanya file sumber yang ukurannya berbeda dari file tujuan.

--start-after

string

Mengembalikan objek yang berada setelah nilai yang ditentukan dalam urutan alfabetis, tidak termasuk nilai tersebut.

--storage-class

string

Kelas penyimpanan objek. Nilai yang valid:

• Standard: Penyimpanan Standar.

• IA: Penyimpanan Akses Jarang.

• Archive: Archive Storage.

• ColdArchive: Penyimpanan Arsip Dingin.

• DeepColdArchive: Deep Cold Archive.

--tagging

strings

Tag untuk objek, dalam format key=value.

--tagging-directive

string

Menentukan cara mengatur tag untuk objek tujuan. Nilai yang valid:

• COPY

• REPLACE

-u, --update

/

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

--ignore-existing

/

Melewati file yang sudah ada di tujuan.

--version-id

string

ID versi objek.

--write-buffer-size

SizeSuffix

Ukuran buffer memori yang digunakan untuk penulisan. Secara otomatis disejajarkan ke batas 4 KB. Mendukung sufiks B / K / M (default: 128 KiB). Rentang valid: 0–32 MiB.