initiate-multipart-upload -

Perintah initiate-multipart-upload memulai tugas unggah multi-bagian.

Catatan Penggunaan

Saat menjalankan perintah initiate-multipart-upload, Object Storage Service (OSS) membuat dan mengembalikan ID unggah yang unik secara global untuk mengidentifikasi tugas unggah multi-bagian tersebut. ID ini dapat digunakan untuk melakukan operasi terkait, seperti membatalkan atau mengkueri unggah multi-bagian.
Memulai permintaan unggah multi-bagian tidak memengaruhi objek yang sudah ada dengan nama yang sama.

Izin

Secara default, Akun Alibaba Cloud memiliki izin penuh. Pengguna RAM atau Peran RAM di bawah Akun Alibaba Cloud tidak memiliki izin apa pun secara default. Akun Alibaba Cloud atau administrator akun harus memberikan izin operasi melalui Kebijakan RAM atau Kebijakan bucket.

API	Aksi	Definisi
InitiateMultipartUpload	`oss:PutObject`	Menginisialisasi task unggah multi-bagian.
	`oss:PutObjectTagging`	Saat menginisialisasi task unggah multi-bagian, jika Anda menentukan tag objek melalui x-oss-tagging, izin ini diperlukan.
	`kms:GenerateDataKey`	Saat mengunggah objek, jika metadata objek berisi X-Oss-Server-Side-Encryption: KMS, kedua izin ini diperlukan.
	`kms:Decrypt`

Sintaksis Perintah

ossutil api initiate-multipart-upload --bucket value --key value [flags]

Parameter	Tipe	Deskripsi
--bucket	string	Nama bucket.
--key	string	Jalur lengkap objek.
--encoding-type	string	Menentukan encoding dari konten yang dikembalikan.
--content-encoding	string	Format encoding konten objek saat objek diunduh.
--content-type	string	Tipe konten objek.
--content-disposition	string	Nama objek saat objek diunduh.
--cache-control	string	Perilaku cache halaman web saat objek diunduh.
--metadata	stringArray	Metadata pengguna objek dalam format key=value. Untuk menentukan metadata kustom, Anda harus mengonfigurasi parameter dengan awalan x-oss-meta-*.
--server-side-data-encryption	string	Algoritma enkripsi objek.
--server-side-encryption	string	Metode Enkripsi sisi server yang digunakan untuk mengenkripsi setiap bagian objek yang ingin Anda unggah.
--server-side-encryption-key-id	string	ID kunci master pelanggan (CMK) yang dikelola oleh Key Management Service (KMS).
--storage-class	string	Kelas penyimpanan objek.
--tagging	string	Tag objek.
--expires	string	Waktu kedaluwarsa dalam milidetik.
--forbid-overwrite	string	Menentukan apakah akan menimpa objek yang memiliki nama yang sama saat Anda memanggil operasi CompleteMultipartUpload.

Catatan

Perintah initiate-multipart-upload berkorespondensi dengan Operasi API InitiateMultipartUpload. Untuk informasi selengkapnya tentang parameter dalam operasi API tersebut, lihat InitiateMultipartUpload.
Untuk informasi selengkapnya tentang opsi baris perintah global yang didukung, lihat Opsi baris perintah global yang didukung.

Contoh

Memulai tugas unggah multi-bagian.

ossutil api initiate-multipart-upload --bucket examplebucket --key exampleobject

Memulai tugas unggah multi-bagian dan menampilkan hasil dalam format JSON.

ossutil api initiate-multipart-upload --bucket examplebucket --key exampleobject --output-format json

Memulai tugas unggah multi-bagian dan menampilkan hasil dalam format YAML.

ossutil api initiate-multipart-upload --bucket examplebucket --key exampleobject --output-format yaml

Memulai tugas unggah multi-bagian dan menentukan metadata kustom.

ossutil api initiate-multipart-upload --bucket examplebucket --key exampleobject --metadata user=aliyun --metadata email=ali***@aliyuncs.com

Memulai tugas unggah multi-bagian dan menentukan tag objek.

ossutil api initiate-multipart-upload --bucket examplebucket --key exampleobject --tagging "TagA=A&TagB=B"

Memulai tugas unggah multi-bagian dan menentukan metode enkripsi sisi server untuk objek.

ossutil api initiate-multipart-upload --bucket examplebucket --key exampleobject --server-side-encryption KMS --server-side-data-encryption SM4 --server-side-encryption-key-id 9468da86-3509-4f8d-a61e-6eab1eac****

Memulai tugas unggah multi-bagian dan mencegah penimpaan objek yang memiliki nama yang sama.

ossutil api initiate-multipart-upload --bucket examplebucket --key exampleobject --forbid-overwrite true

Memulai tugas unggah multi-bagian dan menentukan perilaku cache halaman web saat objek diunduh.

ossutil api initiate-multipart-upload --bucket examplebucket --key exampleobject --cache-control no-cach

Memulai tugas unggah multi-bagian dan menentukan nama objek saat diunduh.

ossutil api initiate-multipart-upload --bucket examplebucket --key exampleobject --content-disposition "attachment;filename=oss_download.jpg"