ListMultipartUploads - Object Storage Service

Menampilkan semua tugas unggah multipart yang sedang berlangsung, baik yang belum selesai maupun yang belum dibatalkan.

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	Aksi	Definisi
ListMultipartUploads	`oss:ListMultipartUploads`	Menampilkan semua peristiwa unggah multipart yang sedang berlangsung, yaitu peristiwa unggah multipart yang telah diinisialisasi tetapi belum selesai atau dibatalkan.

Sintaks permintaan

Get /?uploads HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: Signature

Parameter permintaan

Parameter	Tipe	Deskripsi
delimiter	String	Karakter yang digunakan untuk mengelompokkan objek berdasarkan nama. Jika Anda menentukan parameter Delimiter dalam permintaan, respons akan berisi elemen CommonPrefixes. Objek yang namanya mengandung string yang sama dari awalan hingga kemunculan berikutnya dari delimiter dikelompokkan sebagai elemen hasil tunggal dalam CommonPrefixes.
max-uploads	Integer	Jumlah maksimum tugas unggah multipart yang dapat dikembalikan untuk permintaan saat ini. Nilai default: 1000. Nilai maksimum: 1000.
key-marker	String	Parameter ini digunakan bersama dengan parameter upload-id-marker untuk menentukan posisi dari mana daftar berikutnya dimulai. Jika parameter upload-id-marker tidak disetel, Object Storage Service (OSS) mengembalikan semua tugas unggah multipart di mana nama objek secara alfabetis setelah nilai key-marker. Jika parameter upload-id-marker disetel, respons mencakup tugas-tugas berikut: Tugas unggah multipart di mana nama objek secara alfabetis setelah nilai key-marker dalam urutan alfabetis Tugas unggah multipart di mana nama objek sama dengan nilai parameter key-marker tetapi ID unggahannya lebih besar dari nilai parameter upload-id-marker
prefix	String	Awalan yang harus terkandung dalam nama objek yang dikembalikan. Jika Anda menentukan awalan dalam permintaan, awalan yang ditentukan termasuk dalam respons. Catatan Anda dapat menggunakan awalan untuk mengelompokkan dan mengelola objek di bucket dengan cara yang sama seperti Anda mengelola folder dalam sistem file.
upload-id-marker	String	ID unggah dari tugas unggah multipart setelah mana daftar dimulai. Parameter ini digunakan bersama dengan parameter key-marker. Jika parameter key-marker tidak disetel, OSS mengabaikan parameter upload-id-marker. Jika parameter key-marker dikonfigurasi, hasil kueri mencakup: Tugas unggah multipart di mana nama objek secara alfabetis setelah nilai key-marker dalam urutan alfabetis Tugas unggah multipart di mana nama objek sama dengan nilai parameter key-marker tetapi ID unggahannya lebih besar dari nilai parameter upload-id-marker
encoding-type	String	Tipe pengkodean nama objek dalam respons. Nilai Delimiter, KeyMarker, Prefix, NextKeyMarker, dan Key dapat dikodekan dalam UTF-8. Namun, standar XML 1.0 tidak dapat digunakan untuk mengurai karakter kontrol seperti karakter dengan nilai American Standard Code for Information Interchange (ASCII) dari 0 hingga 10. Anda dapat menyetel parameter encoding-type untuk mengkodekan nilai Delimiter, KeyMarker, Prefix, NextKeyMarker, dan Key dalam respons. Nilai default: null

Elemen respons

Elemen	Tipe	Deskripsi
ListMultipartUploadsResult	Container	Wadah yang menyimpan respons terhadap permintaan ListMultipartUpload. Node anak: Bucket, KeyMarker, UploadIdMarker, NextKeyMarker, NextUploadIdMarker, MaxUploads, Delimiter, Prefix, CommonPrefixes, IsTruncated, dan Upload Node induk: none
Bucket	String	Nama bucket. Node induk: ListMultipartUploadsResult
EncodingType	String	Metode yang digunakan untuk mengkodekan nama objek dalam respons. Jika encoding-type ditentukan dalam permintaan, nilai elemen-elemen termasuk Delimiter, KeyMarker, Prefix, NextKeyMarker, dan Key dikodekan dalam hasil yang dikembalikan. Node induk: ListMultipartUploadsResult
KeyMarker	String	Nama objek yang sesuai dengan tugas unggah multipart setelah mana daftar dimulai. Node induk: ListMultipartUploadsResult
UploadIdMarker	String	ID unggah dari tugas unggah multipart setelah mana daftar dimulai. Node induk: ListMultipartUploadsResult
NextKeyMarker	String	Penanda nama objek dalam respons untuk permintaan berikutnya untuk mengembalikan hasil yang tersisa. Node induk: ListMultipartUploadsResult
NextUploadMarker	String	Nilai NextUploadMarker yang digunakan untuk nilai UploadMarker dalam permintaan berikutnya jika respons tidak berisi semua hasil yang diperlukan. Node induk: ListMultipartUploadsResult
MaxUploads	Integer	Jumlah maksimum tugas unggah multipart yang dikembalikan oleh OSS. Node induk: ListMultipartUploadsResult
IsTruncated	Enumerated string	Menunjukkan apakah daftar tugas unggah multipart yang dikembalikan dalam respons dipotong. Nilai default: false. Nilai valid: true: Hanya sebagian hasil yang dikembalikan kali ini. false: Semua hasil dikembalikan. Node induk: ListMultipartUploadsResult
Upload	Container	Wadah yang menyimpan informasi tentang tugas unggah multipart. Node anak: Key, UploadId, dan Initiated Node induk: ListMultipartUploadsResult
Key	String	Nama objek untuk mana tugas unggah multipart diinisiasi. Node induk: Upload Catatan Hasil yang dikembalikan oleh OSS terdaftar dalam urutan abjad naik nama objek. Beberapa tugas unggah multipart yang diinisiasi untuk mengunggah objek yang sama terdaftar dalam urutan naik ID unggahan.
UploadId	String	ID tugas unggah multipart. Node induk: Upload
Initiated	Date	Waktu ketika tugas unggah multipart diinisiasi. Node induk: Upload

Contoh

Permintaan Contoh

Get /?uploads  HTTP/1.1
Host:oss-example. oss-cn-hangzhou.aliyuncs.com
Date: Thu, 23 Feb 2012 06:14:27 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

Respons Contoh

HTTP/1.1 200 
Server: AliyunOSS
Connection: keep-alive
Content-length: 1839
Content-type: application/xml
x-oss-request-id: 58a41847-3d93-1905-20db-ba6f561c****
Date: Thu, 23 Feb 2012 06:14:27 GMT

<?xml version="1.0" encoding="UTF-8"?>
<ListMultipartUploadsResult xmlns="http://doc.oss-cn-hangzhou.aliyuncs.com">
    <Bucket>oss-example</Bucket>
    <KeyMarker></KeyMarker>
    <UploadIdMarker></UploadIdMarker>
    <NextKeyMarker>oss.avi</NextKeyMarker>
    <NextUploadIdMarker>0004B99B8E707874FC2D692FA5D77D3F</NextUploadIdMarker>
    <Delimiter></Delimiter>
    <Prefix></Prefix>
    <MaxUploads>1000</MaxUploads>
    <IsTruncated>false</IsTruncated>
    <Upload>
        <Key>multipart.data</Key>
        <UploadId>0004B999EF518A1FE585B0C9360DC4C8</UploadId>
        <Initiated>2012-02-23T04:18:23.000Z</Initiated>
    </Upload>
    <Upload>
        <Key>multipart.data</Key>
        <UploadId>0004B999EF5A239BB9138C6227D6****</UploadId>
        <Initiated>2012-02-23T04:18:23.000Z</Initiated>
    </Upload>
    <Upload>
        <Key>oss.avi</Key>
        <UploadId>0004B99B8E707874FC2D692FA5D7****</UploadId>
        <Initiated>2012-02-23T06:14:27.000Z</Initiated>
    </Upload>
</ListMultipartUploadsResult>

OSS SDKs

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

ossutil

Untuk informasi tentang perintah ossutil yang sesuai dengan operasi ListMultipartUploads, lihat list-multipart-uploads.