UploadPart - Upload parts in multipart upload - Object Storage Service

Kullanım notları

UploadPart işlemini çağırmadan önce OSS'ten bir yükleme kimliği almak için InitiateMultipartUpload işlemini çağırın.
Aynı partNumber değeriyle yeni bir parça yüklerseniz mevcut parçanın üzerine yazılır.
OSS, alınan her parçanın MD5 özetini yanıtın ETag üst bilgisine ekler.
InitiateMultipartUpload işleminde x-oss-server-side-encryption üst bilgisini belirtirseniz yüklenen her parça şifrelenir. Yanıt, şifreleme algoritmasını belirten x-oss-server-side-encryption üst bilgisini içerir. Daha fazla bilgi için bkz. InitiateMultipartUpload.

İzinler

Varsayılan olarak Alibaba Cloud hesabı tam izinlere 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, RAM ilkeleri veya Bucket Policy aracılığıyla işlem izinleri vermelidir.

İstek sözdizimi

PUT /ObjectName?partNumber=PartNumber&uploadId=UploadId HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Content-Length: Size
Authorization: SignatureValue

İstek üst bilgileri

Bir UploadPart isteğindeki tüm üst bilgiler ortak istek üst bilgileridir. Daha fazla bilgi için bkz. Ortak istek üst bilgileri.

İstek öğeleri

Öğe

Tür

Gerekli

Örnek

Açıklama

partNumber

Pozitif tamsayı

Evet

1

Parça numarası.

Geçerli değerler: 1 ila 10000.

Bir parçanın boyutu 100 KB ile 5 GB arasında değişir.

Not

Son parça hariç her parça en az 100 KB olmalıdır. OSS hangi parçanın son olduğunu belirleyemediği için UploadPart sırasında parça boyutları doğrulanmaz. Boyut doğrulaması CompleteMultipartUpload işlemini çağırdığınızda gerçekleşir.

uploadId

Dize

Evet

0004B9895DBBB6EC9****

Yüklenecek parçaların ait olduğu nesneyi tanımlayan kimlik.

Yanıt üst bilgileri

Üst Bilgi	Tür	Örnek	Açıklama
Content-MD5	Dize	1B2M2Y8AsgTpgAmY7PhC****	Parçanın MD5 özeti. Önemli Parçanın MD5 özeti, istemci nesneyi yükledikten sonra elde edilir. Bu değer, yanıt gövdesindeki MD5 özeti değildir.
x-oss-hash-crc64ecma	Dize	316181249502703****	Parçanın CRC-64 değeri.

Yanıt ayrıca Date ve x-oss-request-id gibi ortak üst bilgiler de içerir. Ortak HTTP üst bilgileri.

Örnekler

Örnek istek

PUT /multipart.data?partNumber=1&uploadId=0004B9895DBBB6EC9****  HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Content-Length: 6291456
Date: Wed, 22 Feb 2012 08:32:21 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
[6291456 bytes data]

Örnek yanıt

HTTP/1.1 200 OK
Server: AliyunOSS
Content-length: 0
Connection: keep-alive
ETag: "7265F4D211B56873A381D321F586****"
x-oss-request-id: 3e6aba62-1eae-d246-6118-8ff42cd0****
Date: Wed, 22 Feb 2012 08:32:21 GMT
Content-MD5: 1B2M2Y8AsgTpgAmY7Ph****
x-oss-hash-crc64ecma: 316181249502703****
x-oss-server-time: 77

OSS SDK'leri

UploadPart işlemini destekleyen OSS SDK'leri:

ossutil

UploadPart işlemine karşılık gelen ossutil komutu hakkında bilgi için bkz. upload-part.

Hata kodları

Hata Kodu	HTTP Durum Kodu	Açıklama
NoSuchUpload	404	Belirtilen çok parçalı yükleme kimliği mevcut değil.
InvalidArgument	400	Parça numarası 1 ila 10000 aralığında değil.
InvalidDigest	400	İstekteki Content-MD5 değeri, OSS tarafından hesaplanan MD5 özetiyle eşleşmiyor. Aktarım hatalarını önlemek için isteğe Content-MD5 ekleyebilirsiniz. OSS yüklenen verilerin MD5 özetini hesaplar ve bunu Content-MD5 değeriyle karşılaştırır. Eşleşmemesi veri aktarım hatası olduğunu gösterir.

API	Eylem	Açıklama
UploadPart	`oss:PutObject`	Parçaları yükler.