All Products
Search

This Product

    :upload-part-copy

    Document Center

    :upload-part-copy

    Last Updated:May 10, 2026

    Operasi ini mengunggah bagian dengan menyalin data dari objek yang sudah ada.

    Catatan Penggunaan

    • Untuk menyalin objek berukuran lebih dari 1 GB, Anda harus menggunakan perintah upload-part-copy. Untuk menyalin objek berukuran kurang dari 1 GB dalam satu operasi, lihat copy-object.

    • Bucket sumber dan bucket tujuan harus berada di Wilayah yang sama.

    • Sebelum mengunggah bagian menggunakan operasi ini, Anda harus terlebih dahulu memanggil perintah initiate-multipart-upload untuk mendapatkan upload ID.

    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.

    API

    Action

    Description

    UploadPartCopy

    oss:GetObject

    Membaca data dalam objek sumber saat Anda mengunggah bagian dengan menyalin data dari objek yang sudah ada.

    oss:PutObject

    Menulis data ke objek tujuan saat Anda mengunggah bagian dengan menyalin data dari objek yang sudah ada.

    oss:GetObjectVersion

    Saat mengunggah bagian dengan menyalin data dari objek yang sudah ada, jika Anda menentukan versi objek melalui versionId, izin ini diperlukan untuk membaca versi tertentu dari objek sumber.

    Sintaksis

    ossutil api upload-part-copy --bucket value --key value --copy-source value --part-number value --upload-id value [flags]

    Parameter

    Type

    Description

    --bucket

    string

    Nama bucket tujuan.

    --key

    string

    Jalur lengkap objek tujuan.

    --copy-source

    string

    Alamat sumber untuk operasi copy (Anda harus memiliki izin baca untuk sumber) dalam format bucket/UrIEncode(key), di mana nama objek sumber harus di-URL encode.

    --copy-source-if-match

    string

    Menyalin bagian hanya jika ETag objek sumber sesuai dengan ETag yang ditentukan. Jika tidak, error 412 Precondition Failed akan dikembalikan.

    --copy-source-if-modified-since

    string

    Menyalin bagian hanya jika objek sumber telah dimodifikasi sejak waktu yang ditentukan. Jika tidak, error 304 Not Modified akan dikembalikan.

    --copy-source-if-none-match

    string

    Menyalin bagian hanya jika ETag objek sumber tidak sesuai dengan ETag yang ditentukan. Jika tidak, error 304 Not Modified akan dikembalikan.

    --copy-source-if-unmodified-since

    string

    Menyalin bagian hanya jika objek sumber belum dimodifikasi sejak waktu yang ditentukan. Jika tidak, error 412 Precondition Failed akan dikembalikan.

    --copy-source-range

    string

    Rentang byte dari objek sumber yang akan disalin.

    --part-number

    string

    Nomor bagian, yang harus unik untuk setiap bagian dalam unggah multi-bagian.

    --upload-id

    string

    Upload ID untuk unggah multi-bagian.

    Catatan

    • Perintah upload-part-copy membungkus operasi API UploadPartCopy. Untuk detail parameter API, lihat dokumentasi UploadPartCopy.

    • Untuk informasi selengkapnya tentang opsi baris perintah global yang didukung, lihat Global command-line options.

    Contoh

    • Mengunggah bagian dengan menyalin data dari versi terkini srcobject di bucket srcbucket.

      ossutil api upload-part-copy --bucket examplebucket --key exampleobject --copy-source /srcbucket/srcobject --upload-id 123 --part-number 1

    • Mengunggah bagian dengan menyalin data dan memformat output sebagai JSON.

      ossutil api upload-part-copy --bucket examplebucket --key exampleobject --copy-source /srcbucket/srcobject --upload-id 123 --part-number 1 --output-format json

    • Mengunggah bagian dengan menyalin data dan memformat output sebagai YAML.

      ossutil api upload-part-copy --bucket examplebucket --key exampleobject --copy-source /srcbucket/srcobject --upload-id 123 --part-number 1 --output-format yaml

    • Mengunggah bagian dengan menyalin rentang byte tertentu (0 hingga 9) dari objek sumber.

      ossutil api upload-part-copy --bucket examplebucket --key exampleobject --copy-source /srcbucket/srcobject --upload-id 123 --part-number 1 --copy-source-range bytes=0-9

    • Mengunggah bagian dengan menyalin data hanya jika ETag objek sumber srcobject sesuai dengan 123.

      ossutil api upload-part-copy --bucket examplebucket --key exampleobject --copy-source /srcbucket/srcobject --upload-id 123 --part-number 1 --copy-source-if-match 123

    • Mengunggah bagian dengan menyalin data hanya jika objek sumber srcobject tidak dimodifikasi sejak "Mon, 11 May 2020 08:16:23 GMT".

      ossutil api upload-part-copy --bucket examplebucket --key exampleobject --copy-source /srcbucket/srcobject --upload-id 123 --part-number 1 --copy-source-if-unmodified-since "Mon, 11 May 2020 08:16:23 GMT"