Object Storage Service：UploadPartCopy

Catatan penggunaan

Gunakan UploadPartCopy untuk menyalin file berukuran lebih dari 1 GB. Untuk menyalin file berukuran kurang dari 1 GB dalam satu operasi, lihat CopyObject.

Perhatikan hal-hal berikut saat menggunakan operasi UploadPartCopy:

• Bucket sumber dan bucket tujuan untuk operasi UploadPartCopy harus berada di wilayah yang sama.

• Sebelum memanggil operasi ini untuk mengunggah suatu bagian, Anda harus terlebih dahulu memanggil operasi InitiateMultipartUpload untuk mendapatkan ID unggah yang dikeluarkan oleh OSS.

• Jika Anda menentukan header permintaan x-oss-server-side-encryption saat memanggil operasi InitiateMultipartUpload, bagian yang diunggah akan dienkripsi. Header x-oss-server-side-encryption dikembalikan dalam respons terhadap operasi UploadPart. Nilai header ini menunjukkan algoritma enkripsi sisi server yang digunakan untuk bagian tersebut. Untuk informasi selengkapnya, lihat InitiateMultipartUpload.

• Untuk unggah multi-bagian, semua bagian kecuali bagian terakhir harus berukuran lebih dari 100 KB. Operasi UploadPart tidak langsung memeriksa ukuran bagian yang diunggah karena tidak dapat menentukan apakah itu bagian terakhir. Pemeriksaan ukuran hanya dilakukan saat operasi CompleteMultipartUpload dipanggil.

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 RAM Policy atau Bucket policies.

Versi

Jika Anda tidak menentukan versionId dan versi terkini objek yang akan disalin adalah penanda hapus (delete marker), OSS akan mengembalikan error 404 Not Found. Jika Anda menentukan versionId untuk menyalin penanda hapus, OSS akan mengembalikan error 400 Bad Request.

Pengukuran dan penagihan

Saat Anda memanggil operasi UploadPartCopy, jika objek sumber merupakan objek Akses Jarang (IA), biaya pengambilan data untuk objek IA akan dikenakan. Jika objek sumber merupakan objek Arsip yang belum dipulihkan menggunakan operasi RestoreObject dan akses waktu nyata untuk objek Arsip diaktifkan pada bucket tersebut, biaya pengambilan data untuk akses waktu nyata objek Arsip akan dikenakan saat Anda mengakses objek tersebut. Biaya tersebut dibebankan ke bucket sumber. Untuk informasi selengkapnya tentang penagihan, lihat Biaya pemrosesan data.

Sintaksis permintaan

PUT /ObjectName?partNumber=PartNumber&uploadId=UploadId  HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Content-Length: Size
Authorization: SignatureValue
x-oss-copy-source: /SourceBucketName/SourceObjectName
x-oss-copy-source-range: bytes=first-last

Header permintaan

Selain header permintaan umum, permintaan UploadPartCopy menggunakan header permintaan berikut untuk menentukan objek sumber dan rentang salinan.

Header permintaan berikut berlaku untuk objek sumber yang ditentukan oleh x-oss-copy-source.

Contoh

• Contoh permintaan

  PUT /multipart.data?partNumber=1&uploadId=0004B9895DBBB6EC98E36  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
  x-oss-copy-source: /oss-example/src-object
  x-oss-copy-source-range: bytes=100-6291756

  Contoh respons

  HTTP/1.1 200 OK
  Server: AliyunOSS
  Connection: keep-alive
  x-oss-request-id: 3e6aba62-1eae-d246-6118-8ff42cd0****
  Date: Thu, 17 Jul 2014 06:27:54 GMT
  
  <?xml version="1.0" encoding="UTF-8"?>
  <CopyPartResult xmlns=”http://doc.oss-cn-hangzhou.aliyuncs.com”>
      <LastModified>2014-07-17T06:27:54.000Z </LastModified>
      <ETag>"5B3C1A2E053D763E1B002CC607C5****"</ETag>
  </CopyPartResult>

• Contoh permintaan dengan versionId yang ditentukan

  PUT /multipart.data?partNumber=2&uploadId=63C06A5CFF6F4AE4A6BB3AD7F01C****  HTTP/1.1
  Host: oss-example.oss-cn-hangzhou.aliyuncs.com
  Date: Tue, 09 Apr 2019 07:01:56 GMT
  Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
  x-oss-copy-source: /oss-example/src-object?versionId=CAEQMxiBgMC0vs6D0BYiIGJiZWRjOTRjNTg0NzQ1MTRiN2Y1OTYxMTdkYjQ0****

  Contoh respons

  HTTP/1.1 200 OK
  Server: AliyunOSS
  Connection: keep-alive
  x-oss-copy-source-version-id: CAEQMxiBgMC0vs6D0BYiIGJiZWRjOTRjNTg0NzQ1MTRiN2Y1OTYxMTdkYjQ0****
  x-oss-request-id: 5CAC4364B7AEADE017000660
  Date: Tue, 09 Apr 2019 07:01:56 GMT
  
  <?xml version="1.0" encoding="UTF-8"?>
  <CopyPartResult>
    <LastModified>2019-04-09T07:01:56.000Z</LastModified>
    <ETag>"25A9F4ABFCC05743DF6E2C886C56****"</ETag>
  </CopyPartResult>

SDK

Antarmuka baris perintah ossutil

Untuk perintah ossutil yang sesuai dengan operasi UploadPartCopy, lihat upload-part-copy.

Kode error