全部产品
Search
文档中心

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

更新时间:Nov 21, 2025

Perintah set-props digunakan untuk 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 aslinya.

  3. Untuk mengubah kelas penyimpanan atau metadata objek: Operasi ini menulis ulang objek. Perintah memanggil operasi API CopyObject atau menggunakan alur salinan multi-bagian (InitiateMultipartUploadUploadPartCopyCompleteMultipartUpload).

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

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

    • Untuk mengubah izin objek dan kelas penyimpanan sekaligus: Perintah langsung memanggil operasi API CopyObject atau operasi API salinan multi-bagian (InitiateMultipartUploadUploadPartCopyCompleteMultipartUpload) untuk memperbarui izin dan kelas penyimpanan secara bersamaan.

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

int

Ambang batas untuk mengaktifkan unggah, unduh, atau salin multi-bagian untuk file besar. Nilai default adalah 104857600 byte.

--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 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 menyaring path atau nama file.

--filter-from

stringArray

Membaca aturan penyaringan 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 ketika 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 untuk ditransfer. Satuan default adalah byte. Anda dapat menggunakan akhiran: 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 menyaring metadata objek.

--metadata-filter-from

stringArray

Membaca aturan penyaringan metadata objek dari file aturan.

--metadata-include

stringArray

Aturan untuk menyertakan metadata objek.

--min-age

Duration

Menyetel properti hanya untuk file yang dimodifikasi sebelum interval waktu yang ditentukan. Satuan default adalah detik. Anda dapat menggunakan akhiran satuan, misalnya 1h untuk 1 jam.

Catatan

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

--max-age

Duration

Menyetel properti hanya untuk file yang dimodifikasi dalam interval waktu yang ditentukan. Satuan default adalah detik. Anda dapat menggunakan akhiran satuan, misalnya 1h untuk 1 jam.

Catatan

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

--min-mtime

Time

Menyetel properti hanya untuk file yang dimodifikasi setelah waktu yang ditentukan. Waktu harus dalam format UTC. Contohnya, 2006-01-02T15:04:05.

Catatan

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

--max-mtime

Time

Menyetel properti hanya untuk file yang dimodifikasi sebelum waktu yang ditentukan. Waktu harus dalam format UTC. Contohnya, 2006-01-02T15:04:05.

--min-size

SizeSuffix

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

--no-progress

/

Tidak menampilkan bilah kemajuan.

--page-size

int

Jumlah maksimum objek yang dicantumkan pada setiap halaman selama pemrosesan batch. Nilai default adalah 1000. Nilainya 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 yang sesuai berdasarkan ukuran file. Nilainya harus antara 100 KiB dan 5 GiB.

-r, --recursive

/

Menjalankan operasi secara rekursif. Saat 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: Cold Archive.

  • 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 digunakan ketika format file daftar adalah `inventory`.

Untuk informasi selengkapnya, lihat Opsi baris perintah.

Contoh

  • Menyetel izin akses objek menjadi private.

    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
  • Untuk objek dengan 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 sebuah 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 inventarisasi, file csv.gz dan file manifest.json akan dihasilkan dalam hasil inventarisasi. Anda perlu menggunakan kedua file tersebut 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