Jalankan perintah complete-multipart-upload dengan ossutil-Object Storage Service-Alibaba Cloud -

Perintah complete-multipart-upload digunakan untuk menyelesaikan unggah multi-bagian seluruh file.

Catatan penggunaan

Saat memanggil operasi complete-multipart-upload, Anda harus menyediakan daftar semua bagian yang valid, termasuk PartNumber dan ETag. Nilai PartNumber berkisar dari 1 hingga 10.000 dan harus dalam urutan menaik, meskipun tidak harus berurutan. OSS memverifikasi validitas setiap bagian dan memastikan bahwa setiap bagian—kecuali bagian terakhir—memiliki ukuran minimal 100 KB. Setelah verifikasi, bagian-bagian tersebut digabung menjadi satu objek utuh.
OSS memerlukan waktu tertentu untuk memproses permintaan CompleteMultipartUpload. Jika koneksi antara klien dan OSS terputus selama periode ini, OSS tetap melanjutkan pemrosesan permintaan tersebut.
Objek yang sama dapat memiliki beberapa UploadId secara bersamaan. Setelah suatu UploadId diselesaikan, UploadId tersebut menjadi tidak valid, tetapi UploadId lain dari objek tersebut 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. Akun Alibaba Cloud atau administrator akun harus memberikan izin operasi melalui kebijakan RAM atau Bucket Policy.

API	Action	Description
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 perintah

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

Parameter	Type	Description
--bucket	string	Nama bucket tujuan.
--complete-all	string	Menentukan apakah akan mencantumkan semua bagian yang telah diunggah untuk UploadId saat ini.
--complete-multipart-upload	string	Kontainer yang menyimpan konten permintaan CompleteMultipartUpload.
--encoding-type	string	Jenis encoding untuk konten yang dikembalikan.
--forbid-overwrite	string	Menentukan apakah akan menimpa objek yang sudah ada dengan nama yang sama selama operasi CompleteMultipartUpload.
--key	string	Jalur lengkap objek.
--upload-id	string	ID event unggah multi-bagian.

Catatan

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

--complete-multipart-upload

Opsi --complete-multipart-upload mendukung sintaks XML dan JSON. Jika nilai opsi diawali dengan file://, konfigurasi akan dibaca dari file tersebut.

Sintaks XML:

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

Sintaks 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 menyelesaikan unggah multi-bagian untuk objek exampleobject dengan ID unggah 123 di bucket examplebucket.

Gunakan file konfigurasi XML. Konten complete-multipart-upload.xml adalah sebagai berikut:

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

Gunakan file konfigurasi JSON. Konten complete-multipart-upload.json adalah sebagai berikut:

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

Gunakan parameter konfigurasi JSON langsung. Contoh perintah:

ossutil api complete-multipart-upload --bucket examplebucket --key exampleobject --upload-id 123 --complete-multipart-upload "{\"Part\":[{\"PartNumber\":\"1\",\"ETag\":\"\\\"C884BAB4F7A89D38A194568C7DE****\\\"\"},{\"PartNumber\":\"2\",\"ETag\":\"\\\"C884BAB4F7A89D38A194568C7DEA****\\\"\"}]}"

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

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