Topik ini menjelaskan cara menjalankan perintah appendfromfile untuk menambahkan konten ke objek yang dapat ditambahkan di Object Storage Service (OSS).
Catatan penggunaan
Untuk melakukan unggahan tambahan, Anda memerlukan izin
oss:GetObjectdanoss:PutObject. Untuk informasi lebih lanjut, lihat Lampirkan kebijakan kustom ke pengguna RAM.Mulai ossutil versi 1.6.16, Anda dapat langsung menggunakan ossutil sebagai nama biner di baris perintah tanpa perlu memperbarui nama biner berdasarkan sistem operasi. Untuk versi sebelum 1.6.16, Anda harus memperbarui nama biner sesuai dengan sistem operasi. Untuk detail lebih lanjut, lihat Referensi Perintah ossutil.
Untuk informasi lebih lanjut tentang unggahan tambahan, lihat Unggahan Tambahan.
Sintaks perintah
ossutil appendfromfile namafilenama oss://namabucket/namaobjek
[--meta <nilai>]Tabel berikut menjelaskan parameter dan opsi di atas.
Parameter/Opsi | Deskripsi |
localfilename | Jalur lengkap file lokal yang ingin Anda unggah. |
namabucket | Nama bucket yang menyimpan objek ke mana Anda ingin menambahkan konten. |
namaobjek | Nama objek ke mana Anda ingin menambahkan konten. Saat menjalankan perintah appendfromfile untuk melakukan unggahan tambahan, Anda dapat mempertahankan nama asli file lokal untuk objek atau menentukan nama lain. |
--meta | Metadata objek. Anda hanya dapat mengonfigurasi parameter ini pada saat pertama kali menjalankan perintah appendfromfile untuk mengunggah objek. Contoh: |
Contoh
Dalam contoh berikut, perintah appendfromfile pertama kali digunakan untuk mengunggah file lokal bernama exampleobject.txt dari direktori root ke bucket examplebucket dan menyimpannya sebagai objek exampleobject.txt. Kemudian, perintah appendfromfile digunakan untuk menambahkan konten ke objek exampleobject.txt.
Jalankan perintah berikut untuk mengunggah exampleobject.txt dan atur daftar kontrol akses (ACL) objek menjadi private:
ossutil appendfromfile exampleobject.txt oss://examplebucket/exampleobject.txt --meta "x-oss-object-acl:private"Keluaran sampel berikut menunjukkan bahwa file lokal berhasil diunggah ke bucket dan disimpan sebagai objek exampleobject.txt dengan ukuran 5 byte.
total append 5(100.00%) byte,speed is 0.00(KB/s) local file size is 5,the object new size is 5,average speed is 0.04(KB/s)Jalankan perintah berikut untuk menambahkan konten file bernama dest.txt ke exampleobject.txt.
Jika ingin menambahkan lebih banyak konten ke exampleobject.txt, ganti dest.txt dengan nama file yang kontennya ingin ditambahkan:
ossutil appendfromfile dest.txt oss://examplebucket/exampleobject.txtKeluaran sampel berikut menunjukkan bahwa konten telah berhasil ditambahkan ke exampleobject.txt, dengan ukuran objek setelah operasi menjadi 150 byte.
total append 150(100.00%) byte,speed is 0.00(KB/s) local file size is 150,the object new size is 150,average speed is 1.19(KB/s)
Opsi umum
Jika menggunakan ossutil untuk beralih ke bucket di wilayah lain, tambahkan opsi -e untuk menentukan titik akhir wilayah tempat bucket berada. Jika beralih ke bucket milik akun Alibaba Cloud lain, tambahkan opsi -i untuk menentukan ID AccessKey akun tersebut, serta opsi -k untuk menentukan Rahasia AccessKey.
Sebagai contoh, jalankan perintah berikut untuk mengunggah file exampleobject.txt melalui unggahan tambahan ke bucket examplebucket di wilayah Tiongkok (Shanghai), yang dimiliki oleh akun Alibaba Cloud lain:
ossutil appendfromfile exampleobject.txt oss://examplebucket/exampleobject.txt -e shanghai.aliyuncs.com -i yourAccessKeyID -k yourAccessKeySecretUntuk informasi lebih lanjut tentang opsi umum, lihat Opsi Umum.