complete-multipart-upload -

Menyelesaikan tugas pengunggahan multipart dari sebuah objek.

Catatan Penggunaan

Saat menjalankan perintah complete-multipart-upload, Anda harus menyediakan daftar lengkap semua bagian yang valid, termasuk nomor bagian dan tag entitas (ETag) untuk setiap bagian. Nilai PartNumber berkisar antara 1 hingga 10.000. Nomor bagian dalam permintaan dapat tidak berurutan tetapi harus diurutkan secara menaik. Object Storage Service (OSS) memverifikasi keabsahan setiap bagian secara berurutan dan memastikan bahwa setiap bagian, kecuali bagian terakhir, memiliki ukuran minimal 100 KB. Setelah verifikasi selesai, OSS menggabungkan bagian-bagian tersebut menjadi satu objek utuh.
OSS memerlukan waktu tertentu untuk memproses permintaan CompleteMultipartUpload. Jika koneksi klien terputus selama pemrosesan, OSS akan tetap melanjutkan proses permintaan tersebut.
Anda dapat mengunggah objek dengan menjalankan beberapa tugas unggah yang memiliki ID unggah independen. Saat satu tugas unggah selesai, ID unggahnya menjadi tidak valid, namun ID unggah dari tugas lainnya tetap tidak terpengaruh.

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. Administrator akun Alibaba Cloud harus memberikan izin operasi melalui Kebijakan RAM atau Kebijakan Bucket.

API	Aksi	Definisi
CompleteMultipartUpload	`oss:PutObject`	Menggabungkan bagian-bagian menjadi sebuah objek.
CompleteMultipartUpload	`oss:PutObjectTagging`	Saat menggabungkan bagian-bagian menjadi sebuah objek, jika Anda menentukan tag objek melalui x-oss-tagging, izin ini diperlukan.

Sintaks

ossutil api complete-multipart-upload --bucket value --key value --upload-id value --complete-multipart-upload value [flags]

Parameter	Tipe	Deskripsi
--bucket	string	Nama bucket tempat Anda ingin mengunggah objek.
--complete-all	string	Menentukan apakah akan mencantumkan semua bagian yang diunggah menggunakan ID unggah saat ini.
--complete-multipart-upload	string	Kontainer yang menyimpan konten permintaan CompleteMultipartUpload.
--encoding-type	string	Tipe pengkodean nama objek dalam respons.
--forbid-overwrite	string	Menentukan apakah perintah complete-multipart-upload menimpa objek yang ada dengan nama yang sama dengan objek yang ingin Anda unggah.
--key	string	Jalur lengkap objek.
--upload-id	string	ID tugas pengunggahan multipart.

Catatan

Perintah complete-multipart-upload sesuai dengan operasi CompleteMultipartUpload. Untuk informasi lebih lanjut tentang parameter dalam operasi CompleteMultipartUpload, lihat CompleteMultipartUpload.

--complete-multipart-upload

Opsi --complete-multipart-upload mendukung format XML dan JSON. Jika nilai opsi tersebut mencakup awalan file://, konfigurasinya dibaca dari file konfigurasi.

Format XML:

<CompleteMultipartUpload>
  <Part>
    <PartNumber>integer</PartNumber>
    <ETag>string</ETag>
  </Part>
  ...
</CompleteMultipartUpload>

Format JSON:

{
  "Part": [
    {
      "PartNumber": integer,
      "ETag": "string"
    },
    ...
  ]
}

Catatan

Untuk informasi lebih lanjut tentang opsi baris perintah global yang didukung, lihat Opsi baris perintah global.

Contoh

Contoh berikut menunjukkan cara mengunggah objek exampleobject ke bucket examplebucket menggunakan pengunggahan multipart. ID unggah tugas pengunggahan multipart adalah 123.

Buat file konfigurasi XML bernama complete-multipart-upload.xml dan tambahkan kode berikut ke file konfigurasi:

<?xml version="1.0" encoding="UTF-8"?>
<CompleteMultipartUpload>
  <Part>
    <PartNumber>1</PartNumber>
    <ETag>"C884BAB4F7A89D38A194568C7DE****"</ETag>
  </Part>
  <Part>
    <PartNumber>2</PartNumber>
    <ETag>"C884BAB4F7A89D38A194568C7DEA****"</ETag>
  </Part>
</CompleteMultipartUpload>

Contoh perintah:

ossutil api complete-multipart-upload --bucket examplebucket --key exampleobject --upload-id 123 --complete-multipart-upload file://complete-multipart-upload.xml

Buat file konfigurasi JSON bernama complete-multipart-upload.json dan tambahkan kode berikut ke file konfigurasi:

{
  "Part": [
    {
      "PartNumber": "1",
      "ETag": "\"C884BAB4F7A89D38A194568C7DE****\""
    },
    {
      "PartNumber": "2",
      "ETag": "\"C884BAB4F7A89D38A194568C7DEA****\""
    }
  ]
}

Contoh perintah:

ossutil api complete-multipart-upload --bucket examplebucket --key exampleobject --upload-id 123 --complete-multipart-upload file://complete-multipart-upload.json

Konfigurasikan parameter dalam perintah berikut dalam format JSON:

ossutil api complete-multipart-upload --bucket examplebucket --key exampleobject --upload-id 123 --complete-multipart-upload file://complete-multipart-upload.json

Contoh berikut menunjukkan cara mencantumkan semua bagian yang telah diunggah dengan ID unggah 123 di bucket examplebucket:

ossutil api complete-multipart-upload --bucket examplebucket --key exampleobject --upload-id 123 --complete-all yes