UploadPart - Unggah bagian dalam unggah multi-bagian - Object Storage Service

Mengunggah satu bagian ke objek tertentu menggunakan ID unggah yang dikembalikan oleh .

Catatan penggunaan

Sebelum memanggil UploadPart, Anda harus terlebih dahulu memanggil InitiateMultipartUpload untuk mendapatkan ID unggah dari OSS.
Jika Anda mengunggah bagian baru dengan partNumber yang sama, bagian yang ada akan ditimpa.
OSS menyertakan Hash MD5 dari setiap bagian yang diterima dalam header ETag pada respons.
Jika Anda menentukan header x-oss-server-side-encryption dalam InitiateMultipartUpload, setiap bagian yang diunggah akan dienkripsi. Respons menyertakan header x-oss-server-side-encryption yang menunjukkan algoritma enkripsi. Untuk informasi selengkapnya, lihat InitiateMultipartUpload.

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	Tindakan	Deskripsi
UploadPart	`oss:PutObject`	Mengunggah bagian.

Sintaksis permintaan

PUT /ObjectName?partNumber=PartNumber&uploadId=UploadId HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Content-Length: Size
Authorization: SignatureValue

Header permintaan

Semua header dalam permintaan UploadPart merupakan header permintaan umum. Untuk informasi selengkapnya, lihat Header permintaan umum.

Elemen permintaan

Elemen

Type

Wajib

Contoh

Deskripsi

partNumber

Bilangan bulat positif

Nomor bagian.

Nilai valid: 1 hingga 10000.

Ukuran satu bagian berkisar antara 100 KB hingga 5 GB.

Catatan

Setiap bagian kecuali bagian terakhir harus berukuran minimal 100 KB. Ukuran bagian tidak diverifikasi selama UploadPart karena OSS tidak dapat menentukan bagian mana yang terakhir. Verifikasi ukuran dilakukan saat Anda memanggil CompleteMultipartUpload.

uploadId

String

0004B9895DBBB6EC9****

ID yang mengidentifikasi objek tempat bagian yang akan diunggah tersebut dimiliki.

Header respons

Header	Tipe	Contoh	Deskripsi
Content-MD5	String	1B2M2Y8AsgTpgAmY7PhC****	Hash MD5 dari bagian tersebut. Penting Hash MD5 dari bagian tersebut diperoleh setelah klien mengunggah objek. Ini bukan hash MD5 dalam badan respons.
x-oss-hash-crc64ecma	String	316181249502703****	Nilai CRC-64 dari bagian tersebut.

Tanggapan juga mencakup header umum seperti Date dan x-oss-request-id. Lihat Header HTTP Umum.

Contoh

Permintaan contoh

PUT /multipart.data?partNumber=1&uploadId=0004B9895DBBB6EC9****  HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Content-Length: 6291456
Date: Wed, 22 Feb 2012 08:32:21 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
[6291456 bytes data]

Respons contoh

HTTP/1.1 200 OK
Server: AliyunOSS
Content-length: 0
Connection: keep-alive
ETag: "7265F4D211B56873A381D321F586****"
x-oss-request-id: 3e6aba62-1eae-d246-6118-8ff42cd0****
Date: Wed, 22 Feb 2012 08:32:21 GMT
Content-MD5: 1B2M2Y8AsgTpgAmY7Ph****
x-oss-hash-crc64ecma: 316181249502703****
x-oss-server-time: 77

OSS SDK

OSS SDK yang mendukung UploadPart:

ossutil

Untuk informasi tentang perintah ossutil yang sesuai dengan operasi UploadPart, lihat upload-part.

Kode error

Kode error	Kode status HTTP	Deskripsi
NoSuchUpload	404	ID unggah multi-bagian yang ditentukan tidak ada.
InvalidArgument	400	Nomor bagian tidak berada dalam rentang 1 hingga 10000.
InvalidDigest	400	Nilai Content-MD5 dalam permintaan tidak sesuai dengan hash MD5 yang dihitung oleh OSS. Untuk mencegah kesalahan transmisi, Anda dapat menyertakan Content-MD5 dalam permintaan. OSS menghitung hash MD5 dari data yang diunggah dan membandingkannya dengan nilai Content-MD5. Ketidaksesuaian menunjukkan adanya kesalahan transmisi data.