Tüm Ürünler
Search
Belge Merkezi

Object Storage Service:ListMultipartUploads

Son Güncelleme:Oct 01, 2026

Devam eden tüm çok parçalı yükleme görevlerini listeler. Tamamlanmamış veya iptal edilmemiş görevler bu listede yer alır.

İzinler

Varsayılan olarak bir Alibaba Cloud hesabı tam yetkilere sahiptir. Bir Alibaba Cloud hesabı altındaki RAM kullanıcıları veya RAM rolleri varsayılan olarak herhangi bir izne sahip değildir. Alibaba Cloud hesabı veya hesap yöneticisi, işlem izinlerini RAM ilkeleri veya Bucket Policy aracılığıyla vermelidir.


API


Action


Açıklama


ListMultipartUploads


oss:ListMultipartUploads


Başlatılmış ancak henüz tamamlanmamış veya iptal edilmemiş olan tüm devam eden çok parçalı yükleme olaylarını listeler.

İstek sözdizimi

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

İstek parametreleri

Parametre

Tür

Açıklama

delimiter

String

Nesneleri ada göre gruplamak için kullanılan karakter. İstekte Delimiter parametresini belirtirseniz yanıt CommonPrefixes öğesini içerir. Önekten ayırıcının bir sonraki oluşumuna kadar aynı dizeyi içeren nesne adları, CommonPrefixes içinde tek bir sonuç öğesi olarak gruplanır.

max-uploads

Integer

Geçerli istek için döndürülebilecek maksimum çok parçalı yükleme görevi sayısı. Varsayılan değer: 1000. Maksimum değer: 1000.

key-marker

String

Bu parametre, bir sonraki listenin başlayacağı konumu belirtmek üzere upload-id-marker parametresi ile birlikte kullanılır.

  • upload-id-marker parametresi ayarlanmamışsa Object Storage Service (OSS), nesne adları alfabetik olarak key-marker değerinden sonra gelen tüm çok parçalı yükleme görevlerini döndürür.

  • upload-id-marker parametresi ayarlandığında yanıt aşağıdaki görevleri içerir:

    • Nesne adları alfabetik sıraya göre key-marker değerinden sonra gelen çok parçalı yükleme görevleri

    • Nesne adları key-marker parametre değeriyle aynı ancak yükleme kimlikleri upload-id-marker parametre değerinden büyük olan çok parçalı yükleme görevleri

prefix

String

Döndürülen nesne adlarının içermesi gereken önek. İstekte bir önek belirtirseniz belirtilen önek yanıta dahil edilir.

Not

Önekleri kullanarak paketlerdeki nesneleri, bir dosya sistemindeki klasörleri yönettiğiniz şekilde gruplayabilir ve yönetebilirsiniz.

upload-id-marker

String

Listenin başladığı çok parçalı yükleme görevinin yükleme kimliği. Bu parametre key-marker parametresi ile birlikte kullanılır.

  • key-marker parametresi ayarlanmamışsa OSS upload-id-marker parametresini yoksayar.

  • key-marker parametresi yapılandırıldığında sorgu sonucu şunları içerir:

    • Nesne adları alfabetik sıraya göre key-marker değerinden sonra gelen çok parçalı yükleme görevleri

    • Nesne adları key-marker parametre değeriyle aynı ancak yükleme kimlikleri upload-id-marker parametre değerinden büyük olan çok parçalı yükleme görevleri

encoding-type

String

Yanıttaki nesne adının kodlama türü. Delimiter, KeyMarker, Prefix, NextKeyMarker ve Key değerleri UTF-8 ile kodlanabilir. Ancak XML 1.0 standardı, ASCII değeri 0 ile 10 arasında olan karakterler gibi kontrol karakterlerini ayrıştırmak için kullanılamaz. encoding-type parametresini ayarlayarak Delimiter, KeyMarker, Prefix, NextKeyMarker ve Key değerlerinin yanıtta kodlanmasını sağlayabilirsiniz.

Varsayılan değer: null

Yanıt öğeleri

Öğe

Tür

Açıklama

ListMultipartUploadsResult

Container

ListMultipartUpload isteğine verilen yanıtı depolayan kapsayıcı.

Alt düğümler: Bucket, KeyMarker, UploadIdMarker, NextKeyMarker, NextUploadIdMarker, MaxUploads, Delimiter, Prefix, CommonPrefixes, IsTruncated ve Upload

Üst düğümler: yok

Bucket

String

Paket adı.

Üst düğümler: ListMultipartUploadsResult

EncodingType

String

Yanıttaki nesne adını kodlamak için kullanılan yöntem. İstekte encoding-type belirtilirse Delimiter, KeyMarker, Prefix, NextKeyMarker ve Key gibi öğelerin değerleri döndürülen sonuçta kodlanır.

Üst düğümler: ListMultipartUploadsResult

KeyMarker

String

Listenin başladığı çok parçalı yükleme görevine karşılık gelen nesne adı.

Üst düğümler: ListMultipartUploadsResult

UploadIdMarker

String

Listenin başladığı çok parçalı yükleme görevinin yükleme kimliği.

Üst düğümler: ListMultipartUploadsResult

NextKeyMarker

String

Kalan sonuçları döndürmek için yapılacak sonraki istekte kullanılacak nesne adı işaretçisi.

Üst düğümler: ListMultipartUploadsResult

NextUploadMarker

String

Yanıtın tüm gerekli sonuçları içermemesi durumunda sonraki istekte UploadMarker değeri olarak kullanılan NextUploadMarker değeri.

Üst düğümler: ListMultipartUploadsResult

MaxUploads

Integer

OSS tarafından döndürülen maksimum çok parçalı yükleme görevi sayısı.

Üst düğümler: ListMultipartUploadsResult

IsTruncated

Enumerated string

Yanıta döndürülen çok parçalı yükleme görevleri listesinin kesilip kesilmediğini gösterir. Varsayılan değer: false. Geçerli değerler:

  • true: Bu sefer yalnızca sonuçların bir kısmı döndürülür.

  • false: Tüm sonuçlar döndürülür.

Üst düğümler: ListMultipartUploadsResult

Upload

Container

Çok parçalı yükleme görevlerine ilişkin bilgileri depolayan kapsayıcı.

Alt düğümler: Key, UploadId ve Initiated

Üst düğümler: ListMultipartUploadsResult

Key

String

Çok parçalı yükleme görevi başlatılan nesnenin adı.

Üst düğümler: Upload

Not

OSS tarafından döndürülen sonuçlar, nesne adlarının artan alfabetik sırasına göre listelenir. Aynı nesneyi yüklemek için başlatılan birden çok çok parçalı yükleme görevi, yükleme kimliklerinin artan sırasına göre listelenir.

UploadId

String

Çok parçalı yükleme görevinin kimliği.

Üst düğümler: Upload

Initiated

Date

Çok parçalı yükleme görevinin başlatıldığı zaman.

Üst düğümler: Upload

Örnekler

Örnek istekler

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

Örnek yanıtlar

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 SDK'ları

ListMultipartUploads işlemini çağırmak için aşağıdaki programlama dillerine yönelik OSS SDK'larını kullanabilirsiniz:

ossutil

ListMultipartUploads işlemine karşılık gelen ossutil komutu hakkında bilgi için bkz. list-multipart-uploads.