Panggil operasi ListParts untuk mencantumkan semua bagian yang diunggah dengan ID unggah tertentu. - Object Storage Service

Menyediakan daftar semua bagian yang diunggah menggunakan ID unggah tertentu.

Catatan penggunaan

Hasil yang dikembalikan oleh Object Storage Service (OSS) terdaftar dalam urutan menaik berdasarkan nomor bagian.
Disarankan untuk membuat daftar bagian menggunakan data yang direkam secara lokal, bukan mengandalkan nomor bagian dan ETags dari respons permintaan ListParts. Bagian yang diunggah dengan ID unggah tertentu mungkin secara tidak sengaja tertimpa. Dalam hal ini, Anda mungkin perlu menghapus beberapa bagian yang tidak diperlukan sebelum memanggil operasi CompleteMultipartUpload, atau data bagian yang diterima oleh OSS mungkin tidak sesuai harapan karena kesalahan selama transmisi jaringan. Jika nomor bagian dan ETag setiap bagian tidak dicatat secara lokal, data yang sesuai harapan tidak dapat ditemukan dalam respons terhadap permintaan ListParts. Akibatnya, konsistensi dan integritas data yang diunggah ke OSS serta konten aslinya tidak dapat diverifikasi.

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
ListParts	`oss:ListParts`	Menyediakan daftar semua bagian yang diunggah menggunakan ID unggah.

Sintaksis permintaan

Get  /ObjectName?uploadId=UploadId HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: Signature

Header permintaan

Semua header dalam permintaan ListParts adalah header permintaan umum. Untuk informasi lebih lanjut, lihat Header Permintaan Umum.

Parameter permintaan

Parameter	Tipe	Contoh	Deskripsi
uploadId	String	0004B999EF5A239BB9138C6227D6****	ID tugas unggah multipart. Secara default, parameter ini dibiarkan kosong.
max-parts	Integer	1000	Jumlah maksimum bagian yang dapat dikembalikan oleh OSS. Nilai default: 1000. Nilai maksimum: 1000.
part-number-marker	Integer	100	Posisi dari mana daftar dimulai. Semua bagian yang memiliki nomor bagian lebih besar dari nilai parameter ini akan dicantumkan. Secara default, parameter ini dibiarkan kosong.
encoding-type	String	url	Tipe penyandian nama objek dalam respons. Nama objek dapat berisi karakter yang disandikan dalam UTF-8. Namun, standar XML 1.0 tidak dapat digunakan untuk mengurai karakter kontrol tertentu seperti karakter dengan nilai ASCII dari 0 hingga 10. Anda dapat mengonfigurasi parameter ini untuk menyandikan nama objek dalam respons. Secara default, parameter ini dibiarkan kosong. Nilai valid: url.

Header respons

Semua header dalam respons terhadap permintaan ListParts adalah header respons umum. Untuk informasi lebih lanjut, lihat Header Respons Umum.

Elemen respons

Elemen	Tipe	Contoh	Deskripsi
ListPartsResult	Container	N/A	Wadah yang menyimpan respons permintaan ListParts. Node anak: Bucket, Key, UploadId, PartNumberMarker, NextPartNumberMarker, MaxParts, IsTruncated, dan Part Node induk: none
Bucket	String	multipart_upload	Nama bucket. Node induk: ListPartsResult
EncodingType	String	url	Tipe penyandian nama objek dalam respons. Jika parameter encoding-type ditentukan dalam permintaan, nama objek dalam respons disandikan. Node induk: ListPartsResult
Key	String	multipart.data	Nama objek. Node induk: ListPartsResult
UploadId	String	0004B999EF5A239BB9138C6227D69F95	ID tugas unggah. Node induk: ListPartsResult
PartNumberMarker	Integer	10	Posisi dari mana daftar dimulai. Semua bagian yang memiliki nomor bagian lebih besar dari nilai parameter ini akan dicantumkan. Node induk: ListPartsResult
NextPartNumberMarker	Integer	5	Nilai NextPartNumberMarker yang digunakan untuk nilai PartNumberMarker dalam permintaan berikutnya ketika respons tidak berisi semua hasil yang diperlukan. Node induk: ListPartsResult
MaxParts	Integer	1000	Jumlah maksimum bagian dalam respons. Node induk: ListPartsResult
IsTruncated	Enumerated string	false	Menunjukkan apakah daftar bagian yang dikembalikan dalam respons telah dipotong. Nilai true menunjukkan bahwa respons tidak berisi semua hasil yang diperlukan. Nilai false menunjukkan bahwa respons berisi semua hasil yang diperlukan. Nilai valid: true dan false. Node induk: ListPartsResult
Part	Container	N/A	Wadah yang menyimpan informasi tentang bagian. Node anak: PartNumber, LastModified, ETag, dan Size Node induk: ListPartsResult
PartNumber	Integer	1	Nomor yang mengidentifikasi sebuah bagian. Node induk: ListPartsResult.Part
LastModified	Date	2012-02-23T07:01:34.000Z	Waktu ketika bagian diunggah. Node induk: ListPartsResult.Part
ETag	String	3349DC700140D7F86A0784842780****	ETag dari bagian yang diunggah. Node induk: ListPartsResult.Part
Size	Integer	6291456	Ukuran bagian yang diunggah. Node induk: ListPartsResult.Part

Contoh

Permintaan Contoh

Get  /multipart.data?uploadId=0004B999EF5A239BB9138C6227D6****  HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Thu, 23 Feb 2012 07:13:28 GMT
Authorization: OSS qn6q**************:77Dv****************

Respons Sukses Contoh

HTTP/1.1 200 
Server: AliyunOSS
Connection: keep-alive
Content-length: 1221
Content-type: application/xml
x-oss-request-id: 106452c8-10ff-812d-736e-c865294afc1c
Date: Thu, 23 Feb 2012 07:13:28 GMT

<?xml version="1.0" encoding="UTF-8"?>
<ListPartsResult xmlns="http://doc.oss-cn-hangzhou.aliyuncs.com">
    <Bucket>multipart_upload</Bucket>
    <Key>multipart.data</Key>
    <UploadId>0004B999EF5A239BB9138C6227D6****</UploadId>
    <NextPartNumberMarker>5</NextPartNumberMarker>
    <MaxParts>1000</MaxParts>
    <IsTruncated>false</IsTruncated>
    <Part>
        <PartNumber>1</PartNumber>
        <LastModified>2012-02-23T07:01:34.000Z</LastModified>
        <ETag>"3349DC700140D7F86A0784842780****"</ETag>
        <Size>6291456</Size>
    </Part>
    <Part>
        <PartNumber>2</PartNumber>
        <LastModified>2012-02-23T07:01:12.000Z</LastModified>
        <ETag>"3349DC700140D7F86A0784842780****"</ETag>
        <Size>6291456</Size>
    </Part>
    <Part>
        <PartNumber>5</PartNumber>
        <LastModified>2012-02-23T07:02:03.000Z</LastModified>
        <ETag>"7265F4D211B56873A381D321F586****"</ETag>
        <Size>1024</Size>
    </Part>
</ListPartsResult>

SDK OSS

Anda dapat menggunakan SDK OSS untuk bahasa pemrograman berikut untuk memanggil operasi ListParts:

ossutil

Untuk informasi tentang perintah ossutil yang sesuai dengan operasi ListParts, lihat list-parts.