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:
Untuk mengubah hanya daftar kontrol akses (ACL) objek: Perintah memanggil operasi API
PutObjectAcl.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 APIGetObjectTagginguntuk mengambil tag aslinya.Untuk mengubah kelas penyimpanan atau metadata objek: Operasi ini menulis ulang objek. Perintah memanggil operasi API
CopyObjectatau menggunakan alur salinan multi-bagian (InitiateMultipartUpload→UploadPartCopy→CompleteMultipartUpload).Untuk mengubah beberapa properti sekaligus: Perintah memilih kombinasi operasi API yang paling efisien. Contohnya:
Untuk mengubah izin objek dan tag sekaligus: Perintah memanggil
PutObjectAcldanPutObjectTagging.Untuk mengubah izin objek dan kelas penyimpanan sekaligus: Perintah langsung memanggil operasi API
CopyObjectatau operasi API salinan multi-bagian (InitiateMultipartUpload→UploadPartCopy→CompleteMultipartUpload) 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:
|
--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 |
--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:
|
--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
|
--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
|
--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
|
--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:
|
--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:
|
--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 privateMenyetel kelas penyimpanan objek menjadi Archive Storage.
ossutil set-props oss://examplebucket/exampleobject.txt --storage-class ArchiveUntuk 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 -rMenyetel tag objek.
ossutil set-props oss://examplebucket/exampleobject.txt --tagging tag1=value1 --tagging-directive updateMenyetel properti objek dari file daftar.
CatatanSetiap 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/key2ossutil set-props list://list.txtMenyetel properti objek dari file manifes.
CatatanSetelah 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