All Products
Search

This Product

    Object Storage Service:set-props (Setel properti objek)

    Document Center

    Object Storage Service:set-props (Setel properti objek)

    Last Updated:Aug 04, 2026

    Perintah set-props menyetel properti objek, termasuk izin akses, kelas penyimpanan, metadata, dan tag.

    Perhatian

    Perintah set-props memanggil operasi API yang berbeda tergantung pada properti objek yang diubah. Pastikan Anda memiliki izin yang diperlukan. Misalnya, pemanggilan operasi API PutObjectAcl memerlukan izin oss:PutObjectAcl. Operasi API spesifik yang dipanggil adalah sebagai berikut:

    1. Untuk mengubah hanya daftar kontrol akses (ACL) objek: Perintah memanggil operasi API PutObjectAcl.

    2. Untuk mengubah hanya tag objek: Perintah memanggil operasi API PutObjectTagging. Jika pengubahan tag melibatkan pembaruan tag yang sudah ada—misalnya, penambahan inkremental—sistem terlebih dahulu memanggil operasi API GetObjectTagging untuk mengambil tag asli.

    3. Untuk mengubah kelas penyimpanan atau metadata objek: Operasi ini menulis ulang objek. Perintah memanggil operasi API CopyObject atau menggunakan alur copy multipart (InitiateMultipartUpload → UploadPartCopy → CompleteMultipartUpload).

    4. Untuk mengubah beberapa properti sekaligus: Perintah memilih kombinasi operasi API yang paling efisien. Contohnya:

      • Untuk mengubah izin dan tag objek sekaligus: Perintah memanggil PutObjectAcl dan PutObjectTagging.

      • Untuk mengubah izin dan kelas penyimpanan objek sekaligus: Perintah langsung memanggil operasi API CopyObject atau operasi API copy multipart (InitiateMultipartUpload → UploadPartCopy → CompleteMultipartUpload) untuk memperbarui izin dan kelas penyimpanan secara bersamaan.

    Catatan

    Mengubah kelas penyimpanan objek akan dikenai biaya permintaan PUT:

    • Untuk objek yang ukurannya tidak melebihi ambang batas yang ditentukan oleh --bigfile-threshold, ossutil memanggil CopyObject. Permintaan tersebut ditagih berdasarkan kelas penyimpanan objek sumber.

    • Untuk objek yang lebih besar dari ambang batas, ossutil menggunakan copy multipart. Setiap bagian memanggil UploadPartCopy. Permintaan tersebut ditagih berdasarkan kelas penyimpanan objek tujuan.

    • Mengonversi banyak objek ke Deep Cold Archive dapat mengakibatkan biaya permintaan PUT yang tinggi. Tingkatkan nilai --bigfile-threshold atau --part-size untuk mengurangi jumlah permintaan UploadPartCopy. Saat mengubah kelas penyimpanan objek, CopyObject mendukung objek dengan ukuran maksimal 1 GB.

    Untuk aturan penagihan, lihat Biaya permintaan. Untuk panduan penagihan dan penggunaan Deep Cold Archive, lihat Praktik terbaik penggunaan Deep Cold Archive.

    Format perintah

    ossutil set-props oss://bucket[/prefix] [flags]

    Parameter

    Tipe

    Deskripsi

    --acl

    string

    Daftar kontrol akses (ACL) objek. Nilai yang valid:

    • private: privat.

    • public-read: baca-publik.

    • public-read-write: Akses baca dan tulis publik.

    • default: mewarisi dari bucket.

    --bigfile-threshold

    SizeSuffix

    Ambang batas ukuran objek untuk unggah, unduh, atau copy multipart. Objek yang lebih besar dari ambang batas akan menggunakan copy multipart. Nilai default: 100 MiB. Sufiks yang didukung: B, K, M, G, T, dan P.

    --cache-control

    string

    Menentukan perilaku caching halaman web saat objek diunduh.

    --content-disposition

    string

    Menentukan cara objek ditampilkan.

    --content-encoding

    string

    Menentukan format encoding objek.

    --content-type

    string

    Tipe konten objek.

    -d, --dirs

    /

    Menampilkan file dan subdirektori dalam direktori saat ini. Tidak menampilkan semua file di semua subdirektori secara rekursif.

    --encoding-type

    string

    Tipe encoding untuk nama objek atau nama file input. Nilai yang valid: url.

    --end-with

    string

    Mengurutkan objek secara alfabetis dan mengembalikan objek yang berada sebelum atau pada nilai yang ditentukan.

    --exclude

    stringArray

    Aturan untuk mengecualikan path atau nama file.

    --exclude-from

    stringArray

    Membaca aturan pengecualian dari file aturan.

    --expires

    string

    Menentukan waktu kedaluwarsa absolut untuk konten yang di-cache.

    --files-from

    stringArray

    Membaca daftar nama file sumber dari sebuah file. Baris kosong atau baris komentar diabaikan.

    --files-from-raw

    stringArray

    Membaca daftar nama file sumber dari sebuah file.

    --filter

    stringArray

    Aturan untuk memfilter path atau nama file.

    --filter-from

    stringArray

    Membaca aturan filter dari file aturan.

    -f, --force

    /

    Memaksa operasi tanpa prompt konfirmasi.

    --include

    stringArray

    Aturan untuk menyertakan path atau nama file.

    --include-from

    stringArray

    Membaca aturan penyertaan dari file aturan.

    -j, --job

    int

    Jumlah tugas konkuren. Nilai default adalah 3.

    Penting

    Parameter ini hanya berlaku jika Anda menentukan parameter -f, --update, --size-only, atau --ignore-existing.

    --list-objects

    /

    Menggunakan operasi API ListObjects untuk mencantumkan objek.

    --max-size

    SizeSuffix

    Ukuran maksimum file yang akan ditransfer. Satuan default adalah byte. Anda dapat menggunakan sufiks: B, K, M, G, T, atau P. 1 K (KiB) = 1024 B.

    --metadata

    strings

    Menentukan metadata pengguna objek dalam format key=value.

    Contoh: --metadata test=value,test1=value1.

    --metadata-directive

    string

    Instruksi untuk mengubah metadata. Nilai yang valid:

    • replace: Hanya menyimpan metadata yang ditentukan dalam opsi baris perintah.

    • update: Menggabungkan metadata dari baris perintah dan metadata objek.

    • purge: Menghapus semua metadata.

    • delete: Menghapus metadata yang ditentukan dalam opsi baris perintah dan menyimpan sisanya.

    --metadata-exclude

    stringArray

    Aturan untuk mengecualikan metadata objek.

    --metadata-filter

    stringArray

    Aturan untuk memfilter metadata objek.

    --metadata-filter-from

    stringArray

    Membaca aturan filter metadata objek dari file aturan.

    --metadata-include

    stringArray

    Aturan untuk menyertakan metadata objek.

    --min-age

    Duration

    Hanya menyetel properti untuk file yang dimodifikasi sebelum interval waktu yang ditentukan. Satuan default adalah detik. Anda dapat menggunakan sufiks satuan, misalnya 1h untuk 1 jam.

    Catatan

    --min-age 1h hanya menyetel properti untuk file yang dimodifikasi 1 jam yang lalu atau lebih awal.

    --max-age

    Duration

    Hanya menyetel properti untuk file yang dimodifikasi dalam interval waktu yang ditentukan. Satuan default adalah detik. Anda dapat menggunakan sufiks satuan, misalnya 1h untuk 1 jam.

    Catatan

    --max-age 1h hanya menyetel properti untuk file yang dimodifikasi dalam satu jam terakhir.

    --min-mtime

    Time

    Hanya menyetel properti untuk file yang dimodifikasi setelah waktu yang ditentukan. Waktu harus dalam format UTC. Contoh: 2006-01-02T15:04:05.

    Catatan

    --min-mtime "2006-01-02T15:04:05" hanya menyetel properti untuk file yang dimodifikasi setelah pukul 15:04:05 UTC pada 2 Januari 2006.

    --max-mtime

    Time

    Hanya menyetel properti untuk file yang dimodifikasi sebelum waktu yang ditentukan. Waktu harus dalam format UTC. Contoh: 2006-01-02T15:04:05.

    --min-size

    SizeSuffix

    Ukuran minimum file yang akan ditransfer. Satuan default adalah byte. Anda dapat menggunakan sufiks: B, K, M, G, T, atau P. 1 K (KiB) = 1024 B.

    --no-progress

    /

    Tidak menampilkan bilah progres.

    --page-size

    int

    Jumlah maksimum objek yang dicantumkan per halaman selama pemrosesan batch. Nilai default adalah 1000. Nilai dapat berkisar antara 1 hingga 1000.

    --parallel

    int

    Jumlah tugas konkuren untuk operasi pada satu file.

    --part-size

    SizeSuffix

    Ukuran bagian. Secara default, ossutil menghitung ukuran bagian berdasarkan ukuran objek. Bagian yang lebih besar mengurangi jumlah permintaan UploadPartCopy. Rentang nilai yang valid: 100 KiB hingga 5 GiB.

    -r, --recursive

    /

    Menjalankan operasi secara rekursif. Jika Anda menentukan opsi ini, perintah diterapkan ke semua objek yang cocok dalam bucket. Jika tidak, perintah hanya diterapkan pada objek yang ditentukan oleh path.

    --request-payer

    string

    Metode pembayaran untuk permintaan. Tetapkan parameter ini jika Anda menggunakan mode bayar-per-permintaan. Nilai yang valid: requester.

    --start-after

    string

    Mengurutkan objek secara alfabetis dan mengembalikan objek yang berada setelah nilai yang ditentukan.

    --storage-class

    string

    Kelas penyimpanan objek. Nilai yang valid:

    • Standard: Standard.

    • IA: Akses Jarang.

    • Archive: Archive Storage.

    • ColdArchive: Penyimpanan Arsip Dingin.

    • DeepColdArchive: Deep Cold Archive.

    --tagging

    strings

    Menentukan tag objek dalam format key=value.

    Contoh: --tagging tag1=value1,tag2=value2.

    --tagging-directive

    string

    Instruksi untuk mengubah tag. Nilai yang valid:

    • replace: Hanya menyimpan tag yang ditentukan dalam opsi baris perintah.

    • update: Menggabungkan tag dari baris perintah dan tag objek.

    • purge: Menghapus semua tag.

    • delete: Menghapus tag yang ditentukan dalam opsi baris perintah dan menyimpan sisanya.

    --version-id

    string

    ID versi objek.

    --list-format

    string

    Format file daftar. Nilai yang valid: plain, inventory.

    --list-manifest-from

    string

    Membaca deskripsi format file daftar dari sebuah file. Parameter ini wajib ditentukan ketika format file daftar adalah `inventory`.

    Untuk informasi lebih lanjut, lihat Opsi baris perintah.

    Contoh

    • Menyetel izin akses objek menjadi privat.

      ossutil set-props oss://examplebucket/exampleobject.txt --acl private

    • Menyetel kelas penyimpanan objek menjadi Archive Storage.

      ossutil set-props oss://examplebucket/exampleobject.txt --storage-class Archive

    • Mengonversi objek ke Deep Cold Archive secara batch dan memperkirakan biaya permintaan PUT.

      Untuk objek yang ukurannya tidak melebihi 1 GB, tingkatkan ambang batas multipart agar menggunakan CopyObject. Contoh berikut menyetel ambang batas menjadi 1 GB:

      ossutil set-props oss://examplebucket/exampledir/ --storage-class DeepColdArchive --bigfile-threshold 1G -r

      Objek yang lebih besar dari 1 GB memerlukan copy multipart. Tingkatkan ukuran bagian untuk mengurangi jumlah permintaan UploadPartCopy. Contoh berikut menyetel ukuran bagian menjadi 1 GiB:

      ossutil set-props oss://examplebucket/exampledir/ --storage-class DeepColdArchive --part-size 1G -r

      Perkirakan jumlah permintaan UploadPartCopy dengan rumus berikut:

      Bagian per objek = ceil(ukuran objek / ukuran bagian)
Permintaan UploadPartCopy = jumlah objek × bagian per objek

      Sebagai contoh, mengonversi 1.000 objek masing-masing berukuran 10 GiB dengan --part-size 1G menghasilkan 10 permintaan UploadPartCopy per objek dan total 10.000 permintaan. UploadPartCopy ditagih berdasarkan kelas penyimpanan objek tujuan. Oleh karena itu, perkirakan biaya bagian ini berdasarkan aturan penagihan permintaan PUT Deep Cold Archive. Copy multipart juga memanggil InitiateMultipartUpload dan CompleteMultipartUpload. Pencantuman objek dan percobaan ulang juga dapat menimbulkan biaya permintaan.

    • Untuk objek yang memiliki ekstensi .txt, ubah content-type menjadi text/plain.

      ossutil set-props oss://bucket/prefix --content-type text/plain --include "*.txt" --metadata-directive update -r

    • Menyetel tag objek.

      ossutil set-props oss://examplebucket/exampleobject.txt --tagging tag1=value1 --tagging-directive update

    • Menyetel properti objek dari file daftar.

      Catatan

      Setiap baris dalam file daftar merepresentasikan satu objek dan menggunakan format path OSS `oss://{bucket}/{key}`. Sebagai contoh, file list.txt berisi konten berikut:

      oss://examplebucket/key1
oss://examplebucket/key2
      ossutil set-props list://list.txt

    • Menyetel properti objek dari file manifes.

      Catatan

      Setelah menjalankan tugas inventaris, file `csv.gz` dan file `manifest.json` dihasilkan dalam hasil inventaris. Anda perlu menggunakan kedua file ini untuk menyetel properti objek dari file manifes.

      ossutil set-props list://ca8007fc-4123-493e-9a01-dd1511fbac54.csv.gz --list-format inventory --list-manifest-from manifest.json