Unduh dan instal tool baris perintah ossutil - Object Storage Service

ossutil adalah tool baris perintah yang memungkinkan Anda mengunggah file besar secara cepat, mengunduh file, serta menghapus file berdasarkan awalan tertentu. Tool ini kompatibel dengan sistem operasi Windows, Linux, dan macOS. Unduh dan instal versi yang sesuai dengan lingkungan Anda.

Versi baru tersedia

Kami menyarankan penggunaan ossutil 2.0 yang telah ditingkatkan. Untuk informasi lebih lanjut tentang cara menginstal dan mulai menggunakannya, lihat Instal ossutil. ossutil 1.0 tidak lagi menerima pembaruan; fitur baru dan optimalisasi hanya tersedia di ossutil 2.0.

Fitur utama ossutil 2.0:

Struktur perintah baru: Mendukung perintah multi-level, termasuk perintah tingkat API seperti ossutil api put-bucket-acl dan perintah tingkat tinggi seperti ossutil config.
Manajemen konfigurasi yang ditingkatkan: Proses konfigurasi awal disederhanakan. Anda hanya perlu menyediakan ID AccessKey, Rahasia AccessKey, dan ID wilayah untuk menyelesaikan konfigurasi dasar setelah instalasi. Anda juga dapat menggunakan parameter --profile untuk menentukan beberapa file konfigurasi guna fleksibilitas yang lebih besar.
Lebih banyak parameter filter: Untuk perintah pemrosesan batch seperti ls, cp, dan rm, mendukung berbagai kondisi filter berdasarkan path, ukuran file, waktu modifikasi, dan metadata objek. Dukungan ini sangat meningkatkan akurasi dan efisiensi operasi.
Format output yang fleksibel: Parameter --output-format memungkinkan Anda mengatur format output menjadi JSON, YAML, atau XML untuk memenuhi berbagai kebutuhan pemrosesan data. Opsi --output-query memungkinkan Anda memfilter output untuk mengambil informasi yang diperlukan.
Keamanan yang ditingkatkan: Untuk meningkatkan keamanan, ossutil 2.0 memungkinkan Anda mengatur parameter sensitif menggunakan Variabel lingkungan. Hal ini mencegah ekspos kunci di baris perintah dan mengurangi risiko kebocoran data. Selain itu, opsi --dry-run memungkinkan Anda memverifikasi perilaku perintah sebelum menjalankannya, sehingga membantu mencegah operasi yang tidak disengaja.

Versi

Versi saat ini: 1.7.19
Versi sebelumnya: Untuk informasi lebih lanjut tentang kode sumber dan riwayat rilis versi ossutil sebelumnya, lihat GitHub.

Tautan unduh

Tautan unduh	Checksum SHA-256
Linux x86 32-bit	f8a4a7e1df8529b06a3f3cca194a1c99163cb3b8ab3b5d64228c207c3ae63b86
Linux x86 64-bit	dcc512e4a893e16bbee63bc769339d8e56b21744fd83c8212a9d8baf28767343
Linux ARM 32-bit	ffe8b479e5fd3c0e146a14cd32e8ef5736d23f6c8de157944288ee09db2d7b1d
Linux ARM 64-bit	f612c2a88d4d28363e254168d521fac5df632f2547ba84eaebacf6497dc04d57
macOS 64-bit	9cf82a53fe24d8b5cc3dfb441787e0ea19c24dd7a1246653d5f1a28b7923d6fe
macOS ARM 64-bit	10ece4d328c5d2440833adc5f4167168e9b2a4c5d364f673b0c45bcc4fd02ec5
Windows x86 32-bit	772469ef02b91e893f7211acf732c2c07cd93214552ed7cf84157d3d9b9fb799
Windows x86 64-bit	8e9176aedc87d230ccd97dc7236b16564f2a068609ed301acdc73dc27faf7e77

Unduh dan instal ossutil

Linux

Instal ossutil.
```
sudo -v ; curl https://gosspublic.alicdn.com/ossutil/install.sh | sudo bash
```
Catatan
- Anda harus mengekstrak paket ossutil sebelum instalasi. Pastikan Anda telah menginstal tool dekompresi, seperti unzip atau 7z.
- Secara default, ossutil diinstal di direktori /usr/bin/.

Konfigurasikan ossutil.

Masukkan perintah konfigurasi.
```
ossutil config
```
Saat diminta, konfigurasikan path file konfigurasi.
```
Please enter the config file name. The file name can include a path. (Default: /home/user/.ossutilconfig. Press Enter to use the default path.
If you set the path to another file, you must specify the --config-file option to the file when you use other commands): 
```
Secara default, ossutil menyimpan file konfigurasi ke /home/user/.ossutilconfig. Jika Anda menentukan path berbeda untuk file konfigurasi, Anda harus menambahkan opsi -c untuk menentukan file konfigurasi setiap kali menjalankan perintah ossutil. Misalnya, jika Anda menyimpan file konfigurasi ke /home/config, jalankan perintah ls dalam format berikut dan sertakan opsi -c:
```
ossutil ls oss://examplebucket -c /home/config
```
Saat diminta, atur bahasa untuk tool tersebut. Masukkan CH untuk Bahasa Tionghoa atau EN untuk Bahasa Inggris. Secara default, tool ini menggunakan bahasa sistem operasi Anda. Pengaturan ini berlaku setelah perintah config berhasil dijalankan.
Atur bahasa untuk tool tersebut.
Masukkan CH atau EN. Secara default, tool ini menggunakan bahasa yang sama dengan sistem operasi Anda. Konfigurasi ini berlaku setelah Anda menjalankan perintah config.

Saat diminta, atur parameter Endpoint, ID AccessKey, Rahasia AccessKey, dan STSToken. Parameter STSToken hanya diperlukan ketika Anda menggunakan kredensial temporary dari Security Token Service (STS) untuk mengakses OSS. Jika tidak, biarkan parameter ini kosong.

Parameter tersebut dijelaskan sebagai berikut:

Parameter	Wajib	Deskripsi
endpoint	Ya	Masukkan endpoint untuk wilayah tempat bucket Anda berada. Misalnya, atur titik akhir publik ke untuk wilayah atau `https://oss-ap-southeast-1.aliyuncs.com` untuk wilayah Singapura. Untuk mengakses OSS dari layanan Alibaba Cloud lainnya di wilayah yang sama, gunakan titik akhir internal, seperti atau `https://oss-ap-southeast-1-internal.aliyuncs.com`. Untuk informasi lebih lanjut tentang endpoint setiap wilayah, lihat Wilayah dan endpoint. Penting Karena adanya perubahan kebijakan untuk meningkatkan kepatuhan dan keamanan, mulai 20 Maret 2025, pengguna OSS baru harus menggunakan nama domain kustom (CNAME) untuk melakukan operasi API data pada bucket OSS yang berlokasi di wilayah daratan Tiongkok. Titik akhir publik default dibatasi untuk operasi ini. Lihat pengumuman resmi untuk daftar lengkap operasi yang terdampak. Jika Anda mengakses data melalui HTTPS, Anda harus mengikat Sertifikat SSL yang valid ke domain kustom Anda. Ini wajib untuk akses Konsol OSS, karena konsol menerapkan HTTPS.
accessKeyID	Ya	Masukkan Pasangan Kunci Akses akun Anda. Untuk informasi lebih lanjut tentang cara mendapatkan Pasangan Kunci Akses, lihat Buat Pasangan Kunci Akses. Buat Pasangan Kunci Akses untuk Pengguna RAM dengan izin manajemen OSS secara cepat menggunakan skrip ROS Pada halaman Create Stack di Konsol Resource Orchestration Service (ROS), pilih kotak centang konfirmasi di bagian Security Confirmation, lalu klik Create. Untuk informasi lebih lanjut, lihat Buat stack. Setelah stack dibuat, salin Pasangan Kunci Akses yang dibuat dari tab Outputs. Daftar output berisi dua item output: AccessKeySecret dan AccessKeyId. Salin nilai yang sesuai masing-masing.
accessKeySecret	Ya
stsToken	Tidak	Parameter ini hanya diperlukan ketika Anda menggunakan kredensial akses temporary untuk mengakses OSS. Jika tidak, biarkan parameter ini kosong. Untuk informasi lebih lanjut tentang cara menghasilkan token STS, lihat AssumeRole.

Verifikasi bahwa ossutil telah diinstal.
```
ossutil
```
Jika daftar perintah ossutil yang didukung ditampilkan, instalasi berhasil.

Windows

Instal ossutil.
1. Klik tautan unduh untuk mengunduh paket instalasi Windows.
2. Ekstrak paket tersebut dan klik ganda file ossutil.bat.

Konfigurasikan ossutil.

Masukkan perintah konfigurasi.
```
ossutil config
```
Saat diminta, atur path untuk file konfigurasi.
```
Please enter the config file name. The file name can include a path. (Default: C:\\Users\user\.ossutilconfig. Press Enter to use the default path.
If you set the path to another file, you must specify the --config-file option to the file when you use other commands): 
```
Secara default, ossutil menyimpan file konfigurasi ke C:\\Users\user\.ossutilconfig. Jika Anda menentukan path berbeda untuk file konfigurasi, Anda harus menambahkan opsi -c untuk menentukan file konfigurasi setiap kali menjalankan perintah. Misalnya, jika file konfigurasi disimpan ke c:\ossutil\config, jalankan perintah ls dalam format berikut:
```
ossutil ls oss://examplebucket -c c:\ossutil\config
```
Saat diminta, atur bahasa untuk tool tersebut. Masukkan CH untuk Bahasa Tionghoa atau EN untuk Bahasa Inggris. Secara default, tool ini menggunakan bahasa sistem operasi Anda. Konfigurasi ini berlaku setelah Anda menjalankan perintah config.

Saat diminta, atur parameter Endpoint, ID AccessKey, Rahasia AccessKey, dan STSToken. Parameter STSToken hanya diperlukan ketika Anda menggunakan kredensial temporary dari STS untuk mengakses OSS. Jika tidak, biarkan parameter ini kosong.

Tabel berikut menjelaskan parameter tersebut.

Parameter	Wajib	Deskripsi
endpoint	Ya	Masukkan endpoint untuk wilayah tempat bucket Anda berada. Misalnya, atur titik akhir publik ke untuk wilayah atau `https://oss-ap-southeast-1.aliyuncs.com` untuk wilayah Singapura. Untuk mengakses OSS dari layanan Alibaba Cloud lainnya di wilayah yang sama, gunakan titik akhir internal, seperti atau `https://oss-ap-southeast-1-internal.aliyuncs.com`. Untuk informasi lebih lanjut tentang endpoint setiap wilayah, lihat Wilayah dan endpoint. Penting Karena adanya perubahan kebijakan untuk meningkatkan kepatuhan dan keamanan, mulai 20 Maret 2025, pengguna OSS baru harus menggunakan nama domain kustom (CNAME) untuk melakukan operasi API data pada bucket OSS yang berlokasi di wilayah daratan Tiongkok. Titik akhir publik default dibatasi untuk operasi ini. Lihat pengumuman resmi untuk daftar lengkap operasi yang terdampak. Jika Anda mengakses data melalui HTTPS, Anda harus mengikat Sertifikat SSL yang valid ke domain kustom Anda. Ini wajib untuk akses Konsol OSS, karena konsol menerapkan HTTPS.
accessKeyID	Ya	Masukkan Pasangan Kunci Akses akun Anda. Untuk informasi lebih lanjut tentang cara mendapatkan Pasangan Kunci Akses, lihat Buat Pasangan Kunci Akses. Buat Pasangan Kunci Akses untuk Pengguna RAM dengan izin manajemen OSS secara cepat menggunakan skrip ROS Pada halaman Create Stack di Konsol Resource Orchestration Service (ROS), pilih kotak centang konfirmasi di bagian Security Confirmation, lalu klik Create. Untuk informasi lebih lanjut, lihat Buat stack. Setelah stack dibuat, salin Pasangan Kunci Akses yang dibuat dari tab Outputs. Kata kunci output mencakup AccessKeyId dan AccessKeySecret. Salin nilai yang sesuai masing-masing dan simpan dengan aman.
accessKeySecret	Ya
stsToken	Tidak	Parameter ini hanya diperlukan ketika Anda menggunakan kredensial akses temporary untuk mengakses OSS. Jika tidak, biarkan parameter ini kosong. Untuk informasi lebih lanjut tentang cara menghasilkan token STS, lihat AssumeRole.

Verifikasi bahwa ossutil telah diinstal.
```
ossutil
```
Jika daftar perintah ossutil yang didukung ditampilkan, instalasi berhasil.

macOS

Instal ossutil.

sudo -v ; curl https://gosspublic.alicdn.com/ossutil/install.sh | sudo bash

Catatan

Direktori instalasi default adalah /usr/local/bin.

Konfigurasikan ossutil.

Masukkan perintah konfigurasi.
```
ossutil config
```
Saat diminta, atur path untuk file konfigurasi.
```
Please enter the config file name. The file name can include a path. (Default: /Users/user/.ossutilconfig. Press Enter to use the default path.
If you set the path to another file, you must specify the --config-file option to the file when you use other commands): 
```
Secara default, ossutil menyimpan file konfigurasi ke /Users/user/.ossutilconfig.
Jika Anda menentukan path berbeda untuk file konfigurasi, Anda harus menambahkan opsi -c untuk menentukan file konfigurasi setiap kali menjalankan perintah. Misalnya, jika file konfigurasi disimpan ke /home/config, jalankan perintah ls dalam format berikut:
```
ossutil ls oss://examplebucket -c /home/config
```
Saat diminta, atur bahasa untuk tool tersebut. Masukkan CH untuk Bahasa Tionghoa atau EN untuk Bahasa Inggris. Secara default, tool ini menggunakan bahasa sistem operasi Anda. Konfigurasi ini berlaku setelah Anda menjalankan perintah config.

Saat diminta, atur parameter Endpoint, ID AccessKey, Rahasia AccessKey, dan STSToken. Parameter STSToken hanya diperlukan ketika Anda menggunakan kredensial temporary dari STS untuk mengakses OSS. Jika tidak, biarkan parameter ini kosong.

Tabel berikut menjelaskan parameter tersebut.

Parameter	Wajib	Deskripsi
endpoint	Ya	Masukkan endpoint untuk wilayah tempat bucket Anda berada. Misalnya, atur titik akhir publik ke untuk wilayah atau `https://oss-ap-southeast-1.aliyuncs.com` untuk wilayah Singapura. Untuk mengakses OSS dari layanan Alibaba Cloud lainnya di wilayah yang sama, gunakan titik akhir internal, seperti atau `https://oss-ap-southeast-1-internal.aliyuncs.com`. Untuk informasi lebih lanjut tentang endpoint setiap wilayah, lihat Wilayah dan endpoint. Penting Karena adanya perubahan kebijakan untuk meningkatkan kepatuhan dan keamanan, mulai 20 Maret 2025, pengguna OSS baru harus menggunakan nama domain kustom (CNAME) untuk melakukan operasi API data pada bucket OSS yang berlokasi di wilayah daratan Tiongkok. Titik akhir publik default dibatasi untuk operasi ini. Lihat pengumuman resmi untuk daftar lengkap operasi yang terdampak. Jika Anda mengakses data melalui HTTPS, Anda harus mengikat Sertifikat SSL yang valid ke domain kustom Anda. Ini wajib untuk akses Konsol OSS, karena konsol menerapkan HTTPS.
accessKeyID	Ya	Masukkan Pasangan Kunci Akses akun Anda. Untuk informasi lebih lanjut tentang cara mendapatkan Pasangan Kunci Akses, lihat Buat Pasangan Kunci Akses. Buat Pasangan Kunci Akses untuk Pengguna RAM dengan izin manajemen OSS secara cepat menggunakan skrip ROS Pada halaman Create Stack di Konsol Resource Orchestration Service (ROS), pilih kotak centang konfirmasi di bagian Security Confirmation, lalu klik Create. Untuk informasi lebih lanjut, lihat Buat stack. Setelah stack dibuat, salin Pasangan Kunci Akses yang dibuat dari tab Outputs. Kata kunci output mencakup AccessKeyId dan AccessKeySecret. Salin nilai yang sesuai masing-masing dan simpan dengan aman.
accessKeySecret	Ya
stsToken	Tidak	Parameter ini hanya diperlukan ketika Anda menggunakan kredensial akses temporary untuk mengakses OSS. Jika tidak, biarkan parameter ini kosong. Untuk informasi lebih lanjut tentang cara menghasilkan token STS, lihat AssumeRole.

Verifikasi bahwa ossutil telah diinstal.
```
ossutil
```
Jika daftar perintah ossutil yang didukung ditampilkan, instalasi berhasil.

Referensi

Setelah menginstal ossutil, Anda dapat menggunakannya untuk mengunggah, mengunduh, menyalin, dan menghapus objek. Untuk informasi lebih lanjut, lihat cp (unggah objek), cp (unduh objek), cp (salin objek), dan rm (hapus objek).