全部产品
Search

搜索本产品

    ：put-object

    文档中心

    ：put-object

    更新时间：Dec 07, 2025

    Mengunggah objek ke bucket.

    Catatan Penggunaan

    • Ukuran objek yang diunggah tidak boleh melebihi 5 GB.

    • Secara default, jika objek dengan nama yang sama sudah ada dan Anda memiliki izin akses terhadap objek tersebut, objek baru akan menimpa objek yang telah ada.

    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

    PutObject

    oss:PutObject

    Mengunggah objek.

    oss:PutObjectTagging

    Saat mengunggah objek, jika Anda menentukan tag objek melalui x-oss-tagging, izin ini diperlukan.

    kms:GenerateDataKey

    Saat mengunggah objek, jika metadata objek berisi X-Oss-Server-Side-Encryption: KMS, kedua izin ini diperlukan.

    kms:Decrypt

    Sintaksis Perintah

    ossutil api put-object --bucket value --key value [flags]

    Parameter

    Tipe

    Deskripsi

    --body

    string

    Badan permintaan.

    --bucket

    string

    Nama bucket.

    --cache-control

    string

    Perilaku caching halaman web untuk objek.

    --content-disposition

    string

    Menentukan nama objek yang akan diunggah.

    --content-encoding

    string

    Format encoding konten objek.

    --expires

    string

    Waktu kedaluwarsa.

    --forbid-overwrite

    boolean

    Menentukan apakah objek yang sudah ada dengan nama yang sama akan ditimpa atau tidak.

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

    --server-side-data-encryption

    string

    Algoritma enkripsi sisi server yang digunakan saat membuat objek.

    --server-side-encryption

    string

    Metode enkripsi sisi server.

    --server-side-encryption-key-id

    string

    ID kunci master pelanggan (CMK) yang dikelola oleh Key Management Service (KMS).

    --storage-class

    string

    Kelas penyimpanan objek.

    --tagging

    string

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

    Catatan

    • Perintah put-object berkorespondensi dengan Operasi API PutObject. Untuk informasi selengkapnya tentang parameter dalam operasi PutObject, lihat PutObject.

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

    Contoh

    • Mengunggah objek dari string.

      ossutil api put-object --bucket examplebucket --key exampleobject --body "hi oss"

    • Mengunggah objek dari file lokal.

      ossutil api put-object --bucket examplebucket --key exampleobject --body file://uploadFile

    • Mengunggah objek dari string dan menambahkan metadata kustom.

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

    • Mengunggah objek dari string dan menentukan tag untuk objek tersebut.

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

    • Mengunggah objek dari string dan menentukan ACL serta kelas penyimpanan objek tersebut.

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

    • Mengunggah objek dari string dan menentukan metode enkripsi sisi server untuk objek tersebut.

      ossutil api put-object --bucket examplebucket --key exampleobject --body "hi oss" --server-side-encryption KMS --server-side-data-encryption SM4 --server-side-encryption-key-id 9468da86-3509-4f8d-a61e-6eab1eac****

    • Mengunggah objek dari string dan mencegah penimpaan objek yang telah ada dengan nama yang sama.

      ossutil api put-object --bucket examplebucket --key exampleobject --body "hi oss" --forbid-overwrite true

    • Mengunggah objek dari string dan menentukan perilaku caching halaman web saat objek diunduh.

      ossutil api put-object --bucket examplebucket --key exampleobject --body "hi oss" --cache-control no-cache

    • Mengunggah objek dari string dan menentukan nama objek saat diunduh.

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