ListParts - List uploaded parts by upload ID in OSS - Object Storage Service

Kullanım notları

Sonuçlar, parça numaralarına göre artan sırada sıralanır.
Parça listenizi ListParts yanıtlarından değil, yerel olarak kaydettiğiniz parça numaralarından ve ETag değerlerinden oluşturun. Parçalar yanlışlıkla üzerine yazılabilir ve ağ iletim hataları veri tutarsızlıklarına yol açabilir. Parçaların üzerine yazılması durumunda, CompleteMultipartUpload işlemini çağırmadan önce gereksiz parçaları silin. Yerel kayıtlarınız yoksa doğru parçaları belirleyemez veya veri bütünlüğünü doğrulayamazsınız.

İzinler

Varsayılan olarak bir Alibaba Cloud hesabı tam izne 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ı sahibi veya hesap yöneticisi, işlem izinlerini RAM ilkeleri veya Paket İlkesi aracılığıyla vermelidir.

İstek sözdizimi

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

İstek üstbilgileri

Bir ListParts isteğindeki tüm üstbilgiler ortak istek üstbilgileridir. Daha fazla bilgi için bkz. Ortak istek üstbilgileri.

İstek parametreleri

Parametre	Tür	Örnek	Açıklama
uploadId	String	0004B999EF5A239BB9138C6227D6****	Çok parçalı yükleme görevinin kimliği. Varsayılan: boş.
max-parts	Integer	1000	Döndürülecek maksimum parça sayısı. Varsayılan değer: 1000. Maksimum değer: 1000.
part-number-marker	Integer	100	Bu değerden büyük parça numaralarına sahip parçaları listeler. Varsayılan: boş.
encoding-type	String	url	Yanıttaki nesne adının kodlama türü. XML 1.0, ASCII değeri 0 ile 10 arasında olanlar gibi belirli kontrol karakterlerini ayrıştıramaz. Bu tür karakterler içeren nesne adlarını kodlamak için bu parametreyi ayarlayın. Varsayılan: boş. Geçerli değer: url.

Yanıt üstbilgileri

Bir ListParts isteğine verilen yanıtın tüm üstbilgileri ortak yanıt üstbilgileridir. Daha fazla bilgi için bkz. Ortak yanıt üstbilgileri.

Yanıt öğeleri

Öğe	Tür	Örnek	Açıklama
ListPartsResult	Konteyner	Yok	ListParts yanıtı için kök konteyner. Alt düğümler: Bucket, Key, UploadId, PartNumberMarker, NextPartNumberMarker, MaxParts, IsTruncated ve Part Üst düğümler: yok
Bucket	String	multipart_upload	Paket adı. Üst düğümler: ListPartsResult
EncodingType	String	url	Nesne adının kodlama türü. İstekte encoding-type belirtildiğinde döndürülür. Üst düğümler: ListPartsResult
Key	String	multipart.data	Nesne adı. Üst düğümler: ListPartsResult
UploadId	String	0004B999EF5A239BB9138C6227D69F95	Yükleme görevinin kimliği. Üst düğümler: ListPartsResult
PartNumberMarker	Integer	10	İstekte belirtilen parça numarası işaretleyicisi. Bu değerden büyük numaralara sahip parçalar listelenir. Üst düğümler: ListPartsResult
NextPartNumberMarker	Integer	5	Sonuçlar kesildiğinde bir sonraki istekte part-number-marker olarak kullanılacak işaretleyici. Üst düğümler: ListPartsResult
MaxParts	Integer	1000	Yanıttaki maksimum parça sayısı. Üst düğümler: ListPartsResult
IsTruncated	Sabit dize	false	Yanıtın kesilip kesilmediğini gösterir. true: daha fazla parça mevcuttur. false: tüm parçalar döndürüldü. Geçerli değerler: true ve false. Üst düğümler: ListPartsResult
Part	Konteyner	Yok	Parça ayrıntıları için konteyner. Alt düğümler: PartNumber, LastModified, ETag ve Size Üst düğümler: ListPartsResult
PartNumber	Integer	1	Parça numarası. Üst düğümler: ListPartsResult.Part
LastModified	Tarih	2012-02-23T07:01:34.000Z	Parçanın yüklendiği zaman. Üst düğümler: ListPartsResult.Part
ETag	String	3349DC700140D7F86A0784842780****	Yüklenen parçanın ETag'i. Üst düğümler: ListPartsResult.Part
Size	Integer	6291456	Yüklenen parçanın boyutu. Üst düğümler: ListPartsResult.Part

Örnekler

Örnek istek

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

Örnek başarılı yanıt

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 SDK'leri

ListParts işlemini aşağıdaki OSS SDK'leri ile çağırın:

ossutil

ListParts işlemine karşılık gelen ossutil komutu hakkında bilgi için bkz. list-parts.

API	Eylem	Açıklama
ListParts	`oss:ListParts`	Bir yükleme kimliği kullanılarak yüklenen tüm parçaları listeler.