Object Storage Service:cp (unggah file)

Parameter

Tipe

Deskripsi

source

string

Jalur file lokal. Anda dapat menggunakan jalur relatif, jalur mutlak, atau -. Jika Anda menggunakan -, ossutil membaca data dari standard input.

dest

string

Jalur objek tujuan, dalam format oss://bucket[/prefix].

--acl

string

Daftar kontrol akses (ACL) objek. Nilai yang valid:

• private

• public-read

• public-read-write

• default: Objek mewarisi ACL bucket.

--bandwidth-limit

SizeSuffix

Batas laju transfer data. Nilai minimum adalah 1024 B/s. Satuan default adalah B/s.

Anda dapat menentukan satuan untuk nilai bandwidth, seperti B (byte), K (kilobyte), M (megabyte), atau G (gigabyte). Misalnya, 50M menetapkan batas bandwidth sebesar 50 MB/s.

--bigfile-threshold

SizeSuffix

Ambang batas ukuran file untuk memicu unggah multi-bagian, unduh, atau copy. Nilai default adalah 104857600 byte (100 MiB).

--cache-control

string

Menentukan cara klien, seperti browser, menyimpan cache objek.

--content-disposition

string

Menentukan apakah objek ditampilkan inline atau diunduh sebagai lampiran.

--content-encoding

string

Menentukan encoding konten objek.

--content-type

string

Tipe konten objek.

--copy-props

string

Menentukan properti mana yang akan dicopy dari objek sumber. Nilai yang valid:

• none

• metadata

• default

--checkpoint-dir

string

• Jika opsi ini diabaikan, unggah yang dapat dilanjutkan dinonaktifkan.

• Mengaktifkan unggah yang dapat dilanjutkan. Saat opsi ini ditentukan, File titik pemeriksaan disimpan ke subdirektori .ossutil_checkpoint dari direktori yang ditentukan.

-d, --dirs

string

Saat menyalin direktori, opsi ini hanya menyalin file pada tingkat atas direktori sumber dan mengabaikan subdirektorinya.

--encoding-type

string

Tipe encoding untuk nama objek atau nama file input. Satu-satunya nilai yang valid adalah url.

--end-with

string

Hanya menyertakan file yang namanya diakhiri dengan string yang ditentukan.

--exclude

stringArray

Aturan pengecualian untuk jalur atau nama file.

--exclude-from

stringArray

Membaca aturan pengecualian dari file aturan.

--expires

stringArray

Menentukan waktu kedaluwarsa absolut untuk konten yang di-cache.

--files-from

stringArray

Membaca daftar nama file sumber dari file, mengabaikan baris kosong atau baris yang dikomentari. Opsi ini hanya untuk tujuan penyaringan.

--files-from-raw

stringArray

Membaca daftar nama file sumber dari file. Opsi ini hanya untuk tujuan penyaringan.

--filter

stringArray

Aturan penyaringan untuk jalur atau nama file.

--filter-from

stringArray

Membaca aturan penyaringan dari file aturan.

-f, --force

/

Memaksa operasi tanpa prompt konfirmasi.

--include

stringArray

Aturan penyertaan untuk jalur atau nama file.

--include-from

stringArray

Membaca aturan penyertaan dari file aturan.

-j, --job

int

Jumlah tugas unggah konkuren. Nilai default: 3.

--listObjects

/

Menggunakan Operasi API ListObjects untuk mencantumkan objek.

--max-size

SizeSuffix

Ukuran maksimum file yang akan ditransfer. Nilainya dalam byte secara default, tetapi Anda dapat menggunakan sufiks seperti B, K, M, G, T, atau P. 1 K (KiB) = 1024 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 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 mengunggah file yang dimodifikasi setidaknya dalam interval waktu yang ditentukan sebelumnya. Satuan default adalah detik. Anda dapat menggunakan sufiks satuan, seperti 1h untuk 1 jam.

--max-age

Duration

Hanya mengunggah file yang dimodifikasi dalam interval waktu yang ditentukan. Satuan default adalah detik. Anda dapat menggunakan sufiks satuan, seperti 1h untuk 1 jam.

--min-mtime

Time

Hanya mengunggah file yang dimodifikasi setelah waktu yang ditentukan. Waktu harus dalam format UTC. Contoh: 2006-01-02T15:04:05.

--max-mtime

Time

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

--min-size

SizeSuffix

Ukuran minimum file yang akan ditransfer. Nilainya dalam byte secara default, tetapi Anda dapat menggunakan sufiks seperti B, K, M, G, T, atau P. 1 K (KiB) = 1024 B.

--no-progress

/

Menonaktifkan bilah kemajuan.

--page-size

int

Jumlah maksimum objek yang akan dicantumkan dalam setiap permintaan terpaginasi selama unggah batch. Nilainya harus dalam rentang 1 hingga 1.000. Nilai default: 1000.

--parallel

int

Untuk satu file besar, ini menetapkan jumlah bagian yang diunggah secara konkuren.

--part-size

SizeSuffix

Ukuran setiap bagian dalam unggah multi-bagian. Secara default, ossutil menghitung ukuran bagian optimal berdasarkan ukuran file. Nilainya harus dalam rentang 100 KiB hingga 5 GiB.

-r, --recursive

/

Saat mengunggah direktori, Anda harus menentukan opsi ini untuk mengunggah semua file dan subdirektorinya secara rekursif.

--request-payer

string

Menentukan siapa yang membayar permintaan. Tetapkan ke requester jika mode Requester Pays diaktifkan pada bucket tujuan.

--size-only

/

Hanya mengunggah file sumber yang memiliki ukuran berbeda dari file tujuan.

--storage-class

string

Kelas penyimpanan objek. Nilai yang valid:

• Standard

• IA

• Archive

• Cold Archive

• Deep Cold Archive

--tagging

strings

Menentukan tag untuk objek dalam format key=value. Anda dapat menentukan opsi ini beberapa kali untuk menambahkan beberapa tag.

--tagging-directive

string

Menentukan cara mengatur tag objek tujuan. Nilai yang valid:

• COPY

• REPLACE

-u, --update

/

Hanya mengunggah file jika file sumber lebih baru daripada file tujuan atau jika file tujuan tidak ada.

--ignore-existing

/

Melewati file tujuan yang sudah ada.