Object Storage Service:cp (unggah file)

Parameter

Tipe

Deskripsi

source

string

Jalur file lokal. Mendukung jalur relatif, jalur mutlak, dan -. Saat diatur ke -, data dibaca dari standard input.

dest

string

Jalur file di bucket tujuan. Contoh: oss://bucket[/prefix].

--acl

string

Izin akses untuk objek. Nilai yang valid:

• private: private.

• public-read: Public read.

• public-read-write: Public read and write.

• default: inherit from the bucket.

--bandwidth-limit

SizeSuffix

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

Saat mengatur parameter ini, tentukan satuan sesuai kebutuhan. Satuan yang valid meliputi B (bytes), K (kilobytes), M (megabytes), dan G (gigabytes). Misalnya, 50 M menetapkan batas bandwidth menjadi 50 MB/s.

--bigfile-threshold

SizeSuffix

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

--cache-control

string

Menentukan perilaku cache saat objek diunduh oleh browser web.

--content-disposition

string

Menentukan cara objek ditampilkan.

--content-encoding

string

Menyatakan metode encoding 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 jalur direktori checkpoint tidak ditentukan, unggah yang dapat dilanjutkan dinonaktifkan.

• Jika direktori ditentukan, unggah yang dapat dilanjutkan diaktifkan, dan file checkpoint disimpan di subdirektori .ossutil_checkpoint di bawah jalur yang ditentukan.

-d, --dirs

string

Daftar file dan subdirektori di direktori saat ini tanpa merekursif semua file di subdirektori.

--encoding-type

string

Metode encoding untuk nama objek atau nama file input. 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 aturan.

--expires

stringArray

Menentukan waktu kedaluwarsa absolut untuk konten yang di-cache.

--files-from

stringArray

Baca daftar nama file sumber dari file, mengabaikan baris kosong dan baris 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 aturan.

-f, --force

/

Paksa operasi tanpa meminta konfirmasi.

--include

stringArray

Aturan penyertaan untuk jalur atau nama file.

--include-from

stringArray

Baca aturan penyertaan dari file aturan.

-j, --job

int

Jumlah tugas konkuren. Nilai default: 3.

--listObjects

/

Gunakan API ListObjects untuk mendaftar objek.

--max-size

SizeSuffix

Ukuran file maksimum untuk ditransfer. Satuan default adalah byte. Anda juga dapat menggunakan 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 aturan.

--metadata-include

stringArray

Aturan penyertaan untuk metadata objek.

--min-age

Duration

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

--max-age

Duration

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

--min-mtime

Time

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

--max-mtime

Time

Unggah 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 juga dapat menggunakan sufiks: B|K|M|G|T|P. Catatan: 1K (KiB) = 1024B.

--no-progress

/

Jangan tampilkan bilah progres.

--page-size

int

Jumlah maksimum objek yang didaftar per halaman selama unggah batch. Nilai default: 1000. Rentang valid: 1–1000.

--parallel

int

Jumlah tugas konkuren untuk operasi internal pada satu file.

--part-size

SizeSuffix

Ukuran bagian untuk unggah 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 sesuai di bucket. Jika tidak, perintah hanya beroperasi pada objek yang ditentukan oleh jalur tersebut.

--request-payer

string

Metode pembayaran untuk permintaan. Tetapkan parameter ini jika bucket menggunakan mode bayar-per-permintaan. Nilai yang valid: requester.

--size-only

/

Unggah hanya file sumber yang ukurannya berbeda dari file tujuan.

--storage-class

string

Kelas penyimpanan objek. Nilai yang valid:

• Standard: Standard storage.

• IA: Infrequent access storage.

• Archive: Archive Storage.

• ColdArchive: Cold Archive storage.

• DeepColdArchive: Deep Cold Archive storage.

--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

/

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

--ignore-existing

/

Lewati file yang sudah ada di tujuan.