Object Storage Service:CopyObject

Pengendalian versi

Secara default, x-oss-copy-source menyalin versi terkini dari suatu objek. Untuk menyalin versi tertentu, sertakan ID versi dalam x-oss-copy-source. Jika versi sumber yang ditentukan adalah penanda hapus (delete marker), OSS mengembalikan error 404, yang menunjukkan bahwa objek tersebut tidak ada.

Untuk memulihkan versi sebelumnya dari suatu objek, salin versi tersebut ke bucket yang sama. Tindakan ini menjadikan versi yang disalin sebagai versi terkini yang baru.

Jika pengendalian versi diaktifkan untuk bucket tujuan, OSS secara otomatis menghasilkan ID versi unik untuk objek yang baru disalin. ID versi ini dikembalikan dalam header respons x-oss-version-id. Jika pengendalian versi dinonaktifkan atau ditangguhkan untuk bucket tujuan, OSS menghasilkan versi dengan ID versi null untuk objek baru tersebut. Versi baru ini akan menimpa versi yang sudah ada sebelumnya dengan ID versi null.

Batasan

• Batas ukuran objek

  • Objek yang lebih besar dari 5 GB dapat disalin dalam bucket yang sama jika Anda tidak mengubah metode enkripsi atau kelas penyimpanannya.

  • Jika bucket sumber dan tujuan berbeda, dan Anda tidak mengubah metode enkripsi atau kelas penyimpanan objek selama operasi salin, ukuran objek tidak boleh melebihi 5 GB.

  • Jika Anda mengubah metode enkripsi atau kelas penyimpanan objek selama proses salin, ukuran objek dibatasi hingga 1 GB. Untuk objek yang lebih besar, Anda harus menggunakan operasi UploadPartCopy.

• Izin

  Kedua operasi CopyObject dan UploadPartCopy memerlukan izin baca pada objek sumber.

• Jika Anda menggunakan operasi CopyObject pada bucket yang tidak mengaktifkan pengendalian versi dan objek sumber serta tujuan sama:

  • Jika metode enkripsi atau kelas penyimpanan tidak diubah, OSS hanya memodifikasi metadata objek dan tidak menyalin kontennya.

  • Jika metode enkripsi atau kelas penyimpanan diubah, OSS memodifikasi metadata sekaligus menyalin konten objek.

• Objek sumber adalah tautan simbolik

  Jika Anda menggunakan operasi CopyObject pada tautan simbolik, hanya tautan simbolik tersebut yang disalin. Konten objek yang ditunjuk oleh tautan simbolik tidak disalin.

• Hierarchical namespace diaktifkan untuk bucket

  Anda tidak dapat menyalin direktori dalam bucket yang mengaktifkan hierarchical namespace.

• Mencegah konflik penimpaan objek

  Jika Anda mengaktifkan fitur Prevent File Overwrite, Anda tidak dapat menggunakan CopyObject untuk mengubah kelas penyimpanan objek, misalnya dari Standard ke Archive Storage. Sebagai gantinya, gunakan aturan siklus hidup (lifecycle rule) untuk secara otomatis mengubah kelas penyimpanan.

• Batasan ObjectWorm

  Saat menyalin objek yang dapat ditambahkan (appendable object), Anda tidak boleh menyertakan parameter terkait ObjectWorm dalam permintaan.

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.

Penagihan

• Setiap panggilan ke operasi CopyObject dihitung sebagai satu permintaan PUT untuk bucket tujuan.

• Operasi CopyObject meningkatkan penggunaan penyimpanan bucket tujuan.

• Menggunakan CopyObject untuk mengubah kelas penyimpanan objek merupakan operasi penimpaan data. Misalnya, jika objek Akses Jarang (IA) ditimpa dan kelas penyimpanannya diubah menjadi Standard dalam waktu 10 hari sejak pembuatannya, biaya akan dikenakan untuk 20 hari penyimpanan IA karena durasi penyimpanan minimum tidak terpenuhi. Untuk informasi lebih lanjut tentang biaya penyimpanan, lihat Biaya penyimpanan.

• Memanggil operasi CopyObject pada objek Akses Jarang (IA) akan dikenai biaya pengambilan data untuk penyimpanan IA. Jika objek sumber merupakan objek Archive Storage yang belum dipulihkan di bucket dengan akses real-time diaktifkan, biaya pengambilan data untuk akses real-time akan dikenakan. Biaya tersebut dibebankan ke akun pemilik bucket sumber. Untuk informasi selengkapnya mengenai penagihan, lihat Biaya pemrosesan data.

Sintaksis permintaan

PUT /DestObjectName HTTP/1.1
Host: DestBucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue
x-oss-copy-source: /SourceBucketName/SourceObjectName

Header permintaan

Semua header permintaan untuk operasi salin diawali dengan x-oss- dan harus disertakan dalam string signature.

Operasi ini juga menggunakan header permintaan umum, seperti Host dan Date. Untuk informasi lebih lanjut, lihat Header Permintaan Umum.

Header respons

Operasi ini hanya menggunakan header respons umum. Untuk informasi lebih lanjut, lihat Header Respons Umum.

Elemen respons

Contoh

• Pengendalian versi dinonaktifkan

  Permintaan contoh

  PUT /test%2FAK.txt HTTP/1.1
  Host: tesx.oss-cn-zhangjiakou.aliyuncs.com
  Accept-Encoding: identity
  User-Agent: aliyun-sdk-python/2.6.0(Windows/7/AMD64;3.7.0)
  Accept: text/html
  Connection: keep-alive
  x-oss-copy-source: /test/AK.txt
  date: Fri, 28 Dec 2018 09:41:55 GMT
  authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
  Content-Length: 0

  Respons contoh

  Header x-oss-hash-crc64ecma menunjukkan nilai CRC 64-bit objek. Nilai ini dihitung berdasarkan standar CRC-64/XZ. Operasi CopyObject tidak menjamin bahwa objek yang dihasilkan memiliki nilai CRC 64-bit.

  HTTP/1.1 200 OK
  Server: AliyunOSS
  Date: Fri, 28 Dec 2018 09:41:56 GMT
  Content-Type: application/xml
  Content-Length: 184
  Connection: keep-alive
  x-oss-request-id: 5C25EFE4462CE00EC6D87156
  ETag: "F2064A169EE92E9775EE5324D0B1****"
  x-oss-hash-crc64ecma: 12753002859196105360
  x-oss-server-time: 150
  <?xml version="1.0" encoding="UTF-8"?>
  <CopyObjectResult>
    <ETag>"F2064A169EE92E9775EE5324D0B1****"</ETag>
    <LastModified>2018-12-28T09:41:56.000Z</LastModified>
  </CopyObjectResult>

• Menyalin objek tanpa menentukan ID versi

  Permintaan contoh

  PUT /dest-object-example HTTP/1.1
  Host: versioning-copy.oss-cn-hangzhou.aliyuncs.com
  Date: Tue, 09 Apr 2019 03:45:32 GMT
  Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
  x-oss-copy-source: /versioning-copy-source/source-object

  Respons contoh

  Dalam contoh ini, x-oss-copy-source-version-id adalah ID versi objek sumber, yaitu versi terkini. Header x-oss-version-id berisi ID versi objek yang baru disalin.

  HTTP/1.1 200 OK
  x-oss-copy-source-version-id: CAEQNRiBgIC28uaA0BYiIDY5OGIwNmNlNjYyMTRjNTc4N2M2OGNiMjZkZTQ2****
  x-oss-version-id: CAEQNxiBgIDG8uaA0BYiIGZhZDRkZTk5Zjg3YzRhNzdiMWEwZGViNDM1NTFh****
  x-oss-request-id: 5CAC155CB7AEADE01700****
  Content-Type: application/xml
  Content-Length: 184
  Connection: keep-alive
  Date: Tue, 09 Apr 2019 03:45:32 GMT
  Server: AliyunOSS
  <?xml version="1.0" encoding="UTF-8"?>
  <CopyObjectResult>
    <ETag>"C81E728D9D4C2F636F067F89CC14****"</ETag>
    <LastModified>2019-04-09T03:45:32.000Z</LastModified>
  </CopyObjectResult>

• Menyalin objek dengan menentukan ID versi

  Permintaan contoh

  PUT /dest-object-example HTTP/1.1
  Host: versioning-copy.oss-cn-hangzhou.aliyuncs.com
  Date: Tue, 09 Apr 2019 03:45:32 GMT
  Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
  x-oss-copy-source: /versioning-copy-source/source-object?versionId=CAEQNRiBgICv8uaA0BYiIDliZDc3MTc1NjE5MjRkMDI4ZGU4MTZkYjY1ZDgy****

  Respons contoh

  Dalam contoh ini, x-oss-copy-source-version-id adalah ID versi objek sumber, yaitu versi yang ditentukan dalam header permintaan x-oss-copy-source. Header x-oss-version-id berisi ID versi objek yang baru disalin.

  HTTP/1.1 200 OK
  x-oss-copy-source-version-id: CAEQNRiBgICv8uaA0BYiIDliZDc3MTc1NjE5MjRkMDI4ZGU4MTZkYjY1ZDgy****
  x-oss-version-id: CAEQNxiBgMDP8uaA0BYiIDIyNGNhZDQ1M2M3NzRkZThiNzE0N2I3ZDkxOWY4****
  x-oss-request-id: 5CAC155CB7AEADE01700****
  Content-Type: application/xml
  Content-Length: 184
  Connection: keep-alive
  Date: Tue, 09 Apr 2019 03:45:32 GMT
  Server: AliyunOSS
  <?xml version="1.0" encoding="UTF-8"?>
  <CopyObjectResult>
    <ETag>"C4CA4238A0B923820DCC509A6F75****"</ETag>
    <LastModified>2019-04-09T03:45:32.000Z</LastModified>
  </CopyObjectResult>

SDK

Anda dapat menggunakan SDK untuk bahasa-bahasa berikut untuk memanggil operasi ini:

• Java

• Python V2

• PHP V2

• Go V2

• Harmony

• C

• .NET

• Android

• iOS

• Node.js

• Ruby

• Browser.js

• C++

CLI ossutil

Untuk perintah ossutil yang sesuai dengan operasi CopyObject, lihat copy-object.

Kode error

FAQ

Apakah CopyObject mendukung penyalinan beberapa objek sekaligus?

Operasi CopyObject hanya menyalin satu objek. Untuk menyalin beberapa objek secara batch, gunakan tool baris perintah ossutil.