Object Storage Service:cp (unduh file)

Parameter

Tipe

Deskripsi

local-path

string

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

prefix

string

Awalan objek. Jika awalan diakhiri dengan `/`, hanya operasi batch yang didukung. Jika awalan tidak diakhiri dengan `/`, opsi baris perintah menentukan apakah ini merupakan unduhan objek tunggal atau unduhan batch.

--acl

string

Izin akses objek. Nilai:

• private: privat.

• public-read: Akses baca publik.

• public-read-write: Mengizinkan akses baca dan tulis publik.

• default: mewarisi dari bucket.

--bandwidth-limit

SizeSuffix

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

Saat mengonfigurasi parameter ini, tentukan satuan untuk nilai bandwidth sesuai kebutuhan. Satuan opsional meliputi B (byte), K (kilobyte), M (megabyte), dan G (gigabyte). Misalnya, `50 M` menunjukkan batas bandwidth sebesar 50 MB/s.

--bigfile-threshold

SizeSuffix

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

--cache-control

string

Menentukan perilaku cache web saat objek diunduh.

--checkers

int

Jumlah checker yang berjalan secara konkuren (default: 16).

--checkpoint-dir

string

Direktori untuk informasi checkpoint (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 aturan replikasi metadata dan tag. Nilai:

• none: tidak mereplikasi

• metadata: Copy metadata

• default: mereplikasi metadata dan tag

-d, --dirs

string

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

--encoding-type

string

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

--end-with

string

Mengembalikan objek secara alfabetis sebelum nilai yang ditentukan, termasuk nilai tersebut.

--exclude

stringArray

Aturan pengecualian untuk 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 file, mengabaikan baris kosong atau baris komentar.

--files-from-raw

stringArray

Membaca daftar nama file sumber dari file.

--filter

stringArray

Aturan penyaringan untuk jalur atau nama file.

--filter-from

stringArray

Membaca aturan penyaringan dari file aturan.

-f, --force

/

Memaksa operasi tanpa meminta konfirmasi.

--include

stringArray

Aturan penyertaan untuk jalur atau nama file.

--include-from

stringArray

Membaca aturan penyertaan dari file aturan.

-j, --job

int

Jumlah tugas konkuren (default: 3).

--list-objects

/

Menampilkan daftar objek menggunakan API ListObjects.

--max-size

SizeSuffix

Membatasi ukuran maksimum file untuk transfer. Satuan default adalah byte. Anda juga dapat menggunakan akhiran satuan seperti B|K|M|G|T|P. 1K (KiB) = 1024B.

--metadata

strings

Menentukan metadata pengguna untuk objek, menggunakan format `key=value`.

--metadata-directive

string

Menentukan cara mengatur metadata objek target. Nilai:

• COPY

• REPLACE

--metadata-exclude

stringArray

Aturan pengecualian untuk metadata objek.

--metadata-filter

stringArray

Aturan penyaringan untuk metadata objek.

--metadata-filter-from

stringArray

Membaca aturan penyaringan metadata objek dari file aturan.

--metadata-include

stringArray

Aturan penyertaan untuk 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. Format waktu: UTC. Misalnya, `2006-01-02T15:04:05`.

--max-mtime

Time

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

--min-size

SizeSuffix

Membatasi ukuran minimum file untuk transfer. Satuan default adalah byte. Anda juga dapat menggunakan akhiran satuan seperti B|K|M|G|T|P. 1K (KiB) = 1024B.

--no-progress

/

Tidak menampilkan bilah progres.

--page-size

int

Nilai maksimum untuk paginasi objek selama unduhan batch (default: 1000). Rentang nilai: 1 hingga 1000.

--parallel

int

Jumlah tugas konkuren untuk operasi internal file tunggal.

--part-size

SizeSuffix

Ukuran shard. Secara default, sistem menghitung ukuran shard yang sesuai berdasarkan ukuran file. Rentang nilai: 100 KiB hingga 5 GiB.

-r, --recursive

/

Menjalankan operasi secara rekursif. Jika Anda menentukan opsi ini, perintah akan beroperasi pada semua objek yang memenuhi syarat di dalam bucket. Jika tidak, perintah hanya beroperasi pada objek yang ditentukan oleh jalur tersebut.

--request-payer

string

Metode pembayaran untuk permintaan. Jika menggunakan mode pay-by-requester, atur nilai ini. Nilai: `requester`.

--size-only

/

Hanya mengunduh file sumber yang memiliki ukuran berbeda.

--start-after

string

Mengembalikan objek secara alfabetis setelah nilai yang ditentukan, tidak termasuk nilai tersebut.

--storage-class

string

Kelas penyimpanan objek. Nilai:

• Standard: Penyimpanan Standar.

• IA (Infrequent Access): kelas penyimpanan Akses Jarang.

• Archive: Archive Storage.

• ColdArchive: Penyimpanan Arsip Dingin.

• DeepColdArchive: Deep Cold Archive.

--tagging

strings

Menentukan tag objek, menggunakan format `key=value`.

--tagging-directive

string

Menentukan cara mengatur tag objek target. Nilai:

• COPY

• REPLACE

-u, --update

/

Melewati file yang sudah ada di target jika file tersebut lebih baru daripada file sumber.

--ignore-existing

/

Melewati file target yang sudah ada.

--version-id

string

Menentukan ID Versi objek.

--write-buffer-size

SizeSuffix

Ukuran buffer memori yang digunakan untuk menulis. Secara otomatis disejajarkan ke 4 KB. Mendukung akhiran B / K / M (default: 128 KiB). Rentang nilai: 0 hingga 32 MiB.