全部产品
Search

搜索本产品

    ：append-object

    文档中心

    ：append-object

    更新时间：Dec 07, 2025

    Perintah append-object menambahkan data ke suatu objek.

    Catatan Penggunaan

    • Ukuran objek akhir yang dibuat menggunakan perintah append-object tidak boleh melebihi 5 GB.

    • Perintah append-object tidak mendukung enkripsi sisi server dengan Key Management Service (KMS) menggunakan ID customer master key (CMK) tertentu.

    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.

    API

    Action

    Definisi

    AppendObject

    oss:PutObject

    Anda dapat memanggil operasi ini untuk mengunggah objek dengan menambahkannya ke objek yang sudah ada.

    oss:PutObjectTagging

    Saat mengunggah objek dengan menambahkannya ke objek yang sudah ada, jika Anda menentukan tag objek melalui x-oss-tagging, izin ini diperlukan.

    Sintaksis Perintah

    ossutil api append-object --bucket value --key value --position value [flags]

    Parameter

    Tipe

    Deskripsi

    --body

    string

    Badan permintaan.

    --bucket

    string

    Nama bucket.

    --cache-control

    string

    Perilaku caching halaman web untuk objek tersebut.

    --content-disposition

    string

    Nama objek saat diunduh.

    --content-encoding

    string

    Format encoding konten objek.

    --content-md5

    string

    Hash MD5 dari konten objek. Header permintaan ini digunakan untuk memeriksa apakah konten pesan sama dengan konten yang dikirim.

    --expires

    string

    Waktu kedaluwarsa.

    --key

    string

    Jalur lengkap objek.

    --metadata

    stringArray

    Metadata objek. Untuk menentukan metadata kustom, konfigurasikan parameter yang diawali dengan x-oss-meta-*.

    --object-acl

    string

    Daftar kontrol akses (ACL) objek.

    --position

    string

    Posisi tempat mulai menambahkan data.

    --server-side-encryption

    string

    Metode enkripsi sisi server.

    --storage-class

    string

    Kelas penyimpanan objek.

    --tagging

    string

    Tag objek. Anda dapat menentukan multiple tag. Contoh: TagA=A&TagB=B.

    Catatan

    • Perintah append-object berkorespondensi dengan operasi API AppendObject. Untuk informasi selengkapnya tentang parameter operasi API tersebut, lihat AppendObject.

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

    Contoh

    • Tambahkan data dari string ke objek bernama exampleobject.

      ossutil api append-object --bucket examplebucket --key exampleobject --position 0 --body "hi oss"

    • Tambahkan data dari file ke objek bernama exampleobject.

      ossutil api append-object --bucket examplebucket --key exampleobject --position 0 --body file://appendFile

    • Tambahkan data dari string ke objek bernama exampleobject dan sertakan metadata kustom.

      ossutil api append-object --bucket examplebucket --key exampleobject --position 0 --body "hi oss" --metadata user=aliyun --metadata email=ali***@aliyuncs.com

    • Tambahkan data dari string ke objek bernama exampleobject dan tentukan tag objek.

      ossutil api append-object --bucket examplebucket --key exampleobject --position 0 --body "hi oss" --tagging "TagA=A&TagB=B"

    • Tambahkan data dari string ke objek bernama exampleobject dan tentukan daftar kontrol akses (ACL) serta kelas penyimpanan objek.

      ossutil api append-object --bucket examplebucket --key exampleobject --position 0 --body "hi oss" --object-acl private --storage-class IA

    • Tambahkan data dari string ke objek bernama exampleobject dan tentukan metode enkripsi sisi server.

      ossutil api append-object --bucket examplebucket --key exampleobject --position 0 --body "hi oss" --body "hi oss" --server-side-encryption AES256

    • Tambahkan data dari string dan tentukan perilaku caching halaman web untuk objek saat diunduh.

      ossutil api append-object --bucket examplebucket --key exampleobject --position 0 --body "hi oss" --cache-control no-cache

    • Tambahkan data dari string dan tentukan nama file objek saat diunduh.

      ossutil api append-object --bucket examplebucket --key exampleobject --position 0 --body "hi oss" --content-disposition "attachment;filename=oss_download.jpg"

    • Tambahkan data dari string ke objek bernama exampleobject dan tentukan hash Content-MD5 objek tersebut.

      ossutil api append-object --bucket examplebucket --key exampleobject --position 0 --body "hi oss" --content-md5 ohhnqLBJFiKkPSBO1eNaUA==