Object Storage Service：cp (Salin objek)

Parameter

Tipe

Deskripsi

src_bucket

string

Nama bucket sumber.

src_prefix

string

Folder atau awalan tertentu di bucket sumber.

dest_bucket

string

Nama bucket tujuan.

dest_prefix

string

Folder atau awalan tertentu di bucket tujuan.

--acl

string

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

• private: privat

• public-read: Memberikan akses baca publik.

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

• default: Objek mewarisi ACL 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, seperti B (byte), K (kilobyte), M (megabyte), atau 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.

--checkers

int

Jumlah checker yang berjalan secara paralel. Nilai default adalah 16.

--checkpoint-dir

string

Direktori yang menyimpan informasi checkpoint untuk transfer yang dapat dilanjutkan. Nilai default adalah .ossutil_checkpoint/.

--checksum

/

Hanya menyalin objek sumber yang ukuran atau checksum-nya (jika ada) berbeda dari objek tujuan. Opsi ini hanya berlaku untuk operasi salin objek-ke-objek.

--content-disposition

string

Menentukan cara objek ditampilkan.

--content-encoding

string

Menentukan kodek objek.

--content-type

string

Tipe konten objek.

--copy-props

string

Mengatur aturan untuk menyalin properti dan tag selama operasi salin objek-ke-objek. Pengaturan berikut didukung:

• default (nilai default): Menyalin atribut objek dan tag. Atribut objek mencakup content-type, content-language, content-encoding, content-disposition, cache-control, expires, dan metadata (metadata kustom).

• metadata: Hanya menyalin atribut objek.

• none: Hanya menyalin data dan mengabaikan atribut objek serta tag.

-d, --dirs

string

Memproses file dan subdirektori di direktori saat ini, tetapi tidak memproses semua file di semua subdirektori secara rekursif.

--encoding-type

string

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

--end-with

string

Mengembalikan objek yang secara alfabetis berada sebelum atau sama dengan nilai yang ditentukan.

--exclude

stringArray

Aturan pengecualian untuk path 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. Baris kosong atau baris komentar diabaikan.

--files-from-raw

stringArray

Membaca daftar nama file sumber dari file.

--filter

stringArray

Aturan penyaringan untuk path atau nama file.

--filter-from

stringArray

Membaca aturan penyaringan dari file aturan.

-f, --force

/

Memaksa operasi tanpa prompt konfirmasi.

--ignore-existing

/

Melewatkan objek tujuan yang sudah ada.

--include

stringArray

Aturan penyertaan untuk path atau nama file.

--include-from

stringArray

Membaca aturan penyertaan dari file aturan.

-j, --job

int

Jumlah tugas konkuren. Nilai default adalah 3.

--list-objects

/

Menggunakan Operasi API ListObjects untuk mencantumkan objek.

--max-size

SizeSuffix

Membatasi ukuran maksimum objek yang akan ditransfer. Satuan default adalah byte. Anda juga dapat menggunakan akhiran satuan, 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 menyalin objek yang dimodifikasi sebelum interval waktu yang ditentukan. Satuan default adalah detik. Anda dapat menggunakan akhiran satuan. Misalnya, 1h menentukan 1 jam.

--max-age

Duration

Hanya menyalin objek yang dimodifikasi dalam interval waktu yang ditentukan. Satuan default adalah detik. Anda dapat menggunakan akhiran satuan. Misalnya, 1h menentukan 1 jam.

--min-mtime

Time

Hanya menyalin objek yang dimodifikasi setelah waktu yang ditentukan. Waktu harus dalam format UTC, seperti 2006-01-02T15:04:05.

--max-mtime

Time

Hanya menyalin objek yang dimodifikasi sebelum waktu yang ditentukan. Waktu harus dalam format UTC, seperti 2006-01-02T15:04:05.

--min-size

SizeSuffix

Membatasi ukuran minimum objek yang akan ditransfer. Satuan default adalah byte. Anda juga dapat menggunakan akhiran satuan, seperti B, K, M, G, T, atau P. 1 K (KiB) = 1024 B.

--no-progress

/

Tidak menampilkan grafik bilah kemajuan.

--no-error-report

/

Tidak menghasilkan file laporan kesalahan selama pemrosesan batch.

--output-dir

string

Menentukan direktori tempat file laporan kesalahan yang dihasilkan selama pemrosesan batch disimpan. Nilai default adalah ossutil_output.

--page-size

int

Jumlah maksimum objek yang dicantumkan per halaman selama operasi salin batch. Nilai default adalah 1000. Nilainya harus antara 1 hingga 1000.

--parallel

int

Jumlah tugas konkuren untuk operasi pada satu objek.

--part-size

SizeSuffix

Ukuran bagian. Secara default, ossutil menghitung ukuran bagian yang sesuai berdasarkan ukuran objek. Nilainya harus antara 100 KiB hingga 5 GiB.

-r, --recursive

/

Menjalankan operasi secara rekursif. Saat Anda menentukan opsi ini, perintah diterapkan ke semua objek yang cocok di bucket. Jika tidak, perintah hanya diterapkan pada objek yang ditentukan oleh path.

--request-payer

string

Metode pembayaran untuk permintaan. Tetapkan parameter ini ke `requester` jika Anda menggunakan mode bayar-per-permintaan.

--size-only

/

Hanya menyalin objek sumber yang ukurannya berbeda dari objek tujuan.

--start-after

string

Mengembalikan objek yang secara alfabetis berada setelah nilai yang ditentukan.

--storage-class

string

Kelas penyimpanan objek. Nilai yang valid:

• Standard: Jenis Penyimpanan Standar.

• IA: Kelas penyimpanan Akses Jarang.

• Archive: Archive Storage.

• ColdArchive: Penyimpanan Arsip Dingin.

• DeepColdArchive: Deep Cold Archive.

--tagging

string

Menentukan tag objek dalam format key=value.

--tagging-directive

string

Menentukan cara mengatur tag objek tujuan. Nilai yang valid:

• COPY

• REPLACE

-u, --update

/

Hanya menyalin objek sumber yang lebih baru daripada objek tujuan.