全部产品
Search

搜索本产品

    ：upload-part-copy

    文档中心

    ：upload-part-copy

    更新时间：Jul 06, 2025

    Menyalin data dari objek yang ada sebagai bagian dan mengunggah bagian tersebut.

    Catatan penggunaan

    • Untuk menyalin objek berukuran lebih besar dari 1 GB, gunakan perintah upload-part-copy. Untuk menyalin objek berukuran lebih kecil dari 1 GB dalam satu perintah tunggal, lihat copy-object.

    • Saat menjalankan perintah upload-part-copy, bucket sumber dan tujuan harus berada di wilayah yang sama.

    • Sebelum menjalankan perintah upload-part-copy untuk mengunggah bagian, Anda harus menjalankan perintah initiate-multipart-upload untuk mendapatkan ID unggah yang dikeluarkan oleh server Object Storage Service (OSS).

    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 Kebijakan Bucket.

    API

    Aksi

    Definisi

    UploadPartCopy

    oss:GetObject

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

    oss:PutObject

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

    oss:GetObjectVersion

    Saat mengunggah bagian dengan menyalin data dari objek yang 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

    Tipe

    Deskripsi

    --bucket

    string

    Nama bucket tempat objek sumber disimpan.

    --key

    string

    Jalur lengkap objek sumber dari mana Anda ingin menyalin data.

    --copy-source

    string

    Alamat yang digunakan untuk mengakses objek sumber. format: bucket/UrIEncode(key). Anda harus memiliki izin untuk membaca objek sumber. Nama objek sumber harus dienkripsi URL.

    --copy-source-if-match

    string

    Kondisi penyalinan data. Jika nilai ETag objek sumber sama dengan nilai ETag yang ditentukan, OSS menyalin data. Jika tidak, OSS mengembalikan 412 Precondition Failed.

    --copy-source-if-modified-since

    string

    Kondisi transfer objek. Jika waktu yang ditentukan lebih awal daripada waktu terakhir dimodifikasi objek sumber, sistem mentransfer objek dan mengembalikan 200 OK. Jika tidak, sistem mengembalikan 304 Not Modified.

    --copy-source-if-none-match

    string

    Kondisi transfer objek. Jika nilai ETag yang ditentukan tidak cocok dengan nilai ETag objek sumber, OSS mentransfer objek dan mengembalikan 200 OK. Jika tidak, OSS mengembalikan 304 Not Modified.

    --copy-source-if-unmodified-since

    string

    Kondisi transfer objek. Jika waktu yang ditentukan lebih lambat atau sama dengan waktu terakhir dimodifikasi objek sumber, OSS mentransfer objek dan mengembalikan 200 OK. Jika tidak, OSS mengembalikan 412 Precondition Failed.

    --copy-source-range

    string

    Rentang byte yang ingin Anda salin dari objek sumber.

    --metadata-directive

    string

    Metode yang digunakan untuk mengonfigurasi metadata objek tujuan.

    --part-number

    string

    Nomor yang mengidentifikasi sebuah bagian.

    --tagging

    string

    Tag objek tujuan.

    --tagging-directive

    string

    Metode yang digunakan untuk mengonfigurasi tag untuk objek tujuan.

    --upload-id

    string

    ID tugas unggah multipart.

    Catatan

    • Perintah upload-part-copy sesuai dengan operasi UploadPartCopy. Untuk informasi lebih lanjut tentang parameter dalam operasi UploadPartCopy, lihat UploadPartCopy.

    • Untuk informasi lebih lanjut tentang opsi baris perintah global yang didukung, lihat Opsi Baris Perintah Global.

    Contoh

    • Salin data dari versi saat ini srcobject di srcbucket sebagai bagian dan unggah bagian tersebut.

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

    • Salin data dari versi saat ini srcobject di srcbucket sebagai bagian dalam format JSON dan unggah bagian tersebut.

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

    • Salin data dari versi saat ini srcobject di srcbucket sebagai bagian dalam format YAML dan unggah bagian tersebut.

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

    • Salin byte 0 hingga byte 9 dari versi saat ini srcobject di srcbucket sebagai bagian dan unggah bagian tersebut.

      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

    • Salin data dari versi saat ini srcobject di srcbucket sebagai bagian dan unggah bagian tersebut jika ETag srcobject adalah 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

    • Salin data dari versi saat ini srcobject di srcbucket sebagai bagian dan unggah bagian tersebut jika waktu terakhir dimodifikasi lebih awal dari 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"

    • Salin data dari versi saat ini srcobject di srcbucket sebagai bagian, unggah bagian tersebut, dan gunakan tag yang ditentukan dalam permintaan alih-alih tag objek sumber.

      ossutil api upload-part-copy --bucket examplebucket --key exampleobject --copy-source /srcbucket/srcobject --upload-id 123 --part-number 1 --tagging-directive Replace --tagging "TagA=A&TagB=B"