Object Storage Service：cp (unggah file)

Parameter

Tipe

Deskripsi

source

string

Jalur file lokal. Jalur relatif, jalur absolut, dan - didukung. Jika Anda menentukan -, data dibaca dari input standar.

dest

string

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

--acl

string

Izin akses objek. Nilai yang valid:

• private: privat.

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

Saat mengonfigurasi parameter ini, Anda dapat menentukan satuan untuk nilai bandwidth sesuai kebutuhan. Satuan yang valid meliputi B (byte), K (kilobyte), M (megabyte), dan G (gigabyte). Misalnya, 50 M menentukan batas bandwidth sebesar 50 MB/s.

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

--content-disposition

string

Menentukan cara objek ditampilkan.

--content-encoding

string

Mendeklarasikan metode pengkodean objek.

--content-type

string

Tipe konten objek.

--copy-props

string

Menentukan properti mana yang diunggah dari objek sumber. Nilai yang valid:

• none

• metadata

• default

--checkpoint-dir

string

• Jika Anda tidak menentukan direktori untuk operasi yang dapat dilanjutkan, fitur unggah yang dapat dilanjutkan dinonaktifkan.

• Jika Anda menentukan direktori, fitur unggah yang dapat dilanjutkan diaktifkan. File titik pemeriksaan disimpan ke subdirektori .ossutil_checkpoint dalam direktori yang ditentukan.

-d, --dirs

string

Menampilkan file dan subdirektori dalam folder saat ini, bukan menampilkan semua file di semua subdirektori secara rekursif.

--encoding-type

string

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

--end-with

string

Menampilkan objek yang secara alfabetis berada sebelum atau pada nilai 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 sebuah file. Baris kosong atau baris komentar diabaikan.

--files-from-raw

stringArray

Membaca daftar nama file sumber dari sebuah file.

--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 konkuren. Nilai default adalah 3.

--listObjects

/

Menggunakan Operasi API ListObjects untuk mencantumkan objek.

--max-size

SizeSuffix

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

--metadata

strings

Menentukan metadata pengguna objek. Gunakan 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 sebelum interval waktu yang ditentukan. Satuan default adalah detik. Anda dapat menggunakan akhiran untuk satuan tersebut. Misalnya, 1h berarti 1 jam.

--max-age

Duration

Hanya mengunggah file yang dimodifikasi dalam interval waktu yang ditentukan. Satuan default adalah detik. Anda dapat menggunakan akhiran untuk satuan tersebut. Misalnya, 1h berarti 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. Satuan default adalah byte. Anda juga dapat menggunakan akhiran seperti B, K, M, G, T, atau P. 1 K (KiB) = 1024 B.

--no-progress

/

Tidak menampilkan bilah kemajuan.

--page-size

int

Jumlah maksimum objek yang dicantumkan per halaman selama pengunggahan batch. Nilai default adalah 1000. Nilai harus antara 1 dan 1000.

--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 harus antara 100 KiB dan 5 GiB.

-r, --recursive

/

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

--request-payer

string

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

--size-only

/

Hanya mengunggah file sumber yang ukurannya berbeda dari file tujuan.

--storage-class

string

Kelas penyimpanan objek. Nilai yang valid:

• Standard: Standard

• IA: Kelas penyimpanan IA

• Archive: Archive Storage

• ColdArchive: Penyimpanan Arsip Dingin

• DeepColdArchive: Deep Cold Archive

--tagging

strings

Menentukan tag objek. Gunakan format key=value.

--tagging-directive

string

Menentukan cara mengatur tag objek tujuan. Nilai yang valid:

• COPY

• REPLACE

-u, --update

/

Hanya mengunggah file sumber yang lebih baru daripada file tujuan.

--ignore-existing

/

Melewatkan file tujuan yang sudah ada.