ListParts - Daftar bagian yang diunggah berdasarkan ID unggah di OSS - Object Storage Service

Menampilkan semua bagian yang telah diunggah untuk suatu upload ID tertentu.

Catatan penggunaan

Hasil diurutkan secara ascending berdasarkan nomor bagian.
Buat daftar bagian Anda berdasarkan catatan lokal mengenai nomor bagian dan ETag, bukan dari respons ListParts. Bagian dapat tertimpa secara tidak sengaja, dan error transmisi jaringan dapat menyebabkan ketidaksesuaian data. Jika bagian tertimpa, hapus bagian yang tidak diperlukan sebelum memanggil CompleteMultipartUpload. Tanpa catatan lokal, Anda tidak dapat mengidentifikasi bagian yang benar atau memverifikasi integritas data.

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	Deskripsi
ListParts	`oss:ListParts`	Menampilkan semua bagian yang diunggah menggunakan suatu upload ID.

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 merupakan header permintaan umum. Untuk informasi selengkapnya, lihat Header permintaan umum.

Parameter permintaan

Parameter	Tipe	Contoh	Deskripsi
uploadId	String	0004B999EF5A239BB9138C6227D6****	ID dari task unggah multi-bagian. Default: kosong.
max-parts	Integer	1000	Jumlah maksimum bagian yang dikembalikan. Nilai default: 1000. Nilai maksimum: 1000.
part-number-marker	Integer	100	Menampilkan bagian dengan nomor bagian lebih besar dari nilai ini. Default: kosong.
encoding-type	String	url	Tipe encoding untuk nama objek dalam respons. XML 1.0 tidak dapat mengurai karakter kontrol tertentu, seperti karakter dengan nilai ASCII dari 0 hingga 10. Atur parameter ini untuk mengencode nama objek yang mengandung karakter tersebut. Default: kosong. Nilai valid: url.

Header respons

Semua header dalam respons terhadap permintaan ListParts merupakan header respons umum. Untuk informasi selengkapnya, lihat Header respons umum.

Elemen respons

Elemen	Tipe	Contoh	Deskripsi
ListPartsResult	Kontainer	N/A	Kontainer utama untuk respons ListParts. Node anak: Bucket, Key, UploadId, PartNumberMarker, NextPartNumberMarker, MaxParts, IsTruncated, dan Part Node induk: tidak ada
Bucket	String	multipart_upload	Nama bucket. Node induk: ListPartsResult
EncodingType	String	url	Tipe encoding untuk nama objek. Dikembalikan saat encoding-type ditentukan dalam permintaan. Node induk: ListPartsResult
Key	String	multipart.data	Nama objek. Node induk: ListPartsResult
UploadId	String	0004B999EF5A239BB9138C6227D69F95	ID dari task unggah. Node induk: ListPartsResult
PartNumberMarker	Integer	10	Penanda nomor bagian yang ditentukan dalam permintaan. Bagian dengan nomor lebih besar dari nilai ini akan ditampilkan. Node induk: ListPartsResult
NextPartNumberMarker	Integer	5	Penanda yang digunakan sebagai part-number-marker dalam permintaan berikutnya jika hasil dipotong (truncated). Node induk: ListPartsResult
MaxParts	Integer	1000	Jumlah maksimum bagian dalam respons. Node induk: ListPartsResult
IsTruncated	String terenumerasi	false	Menunjukkan apakah respons dipotong. true: masih ada bagian lain yang tersedia. false: semua bagian telah dikembalikan. Nilai valid: true dan false. Node induk: ListPartsResult
Part	Kontainer	N/A	Kontainer untuk detail bagian. Node anak: PartNumber, LastModified, ETag, dan Size Node induk: ListPartsResult
PartNumber	Integer	1	Nomor bagian. Node induk: ListPartsResult.Part
LastModified	Date	2012-02-23T07:01:34.000Z	Waktu saat 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: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

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>

OSS SDKs

Panggil ListParts menggunakan OSS SDK berikut:

ossutil

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