Gunakan Alibaba Cloud CLI untuk Mengelola Sumber Daya OSS - Alibaba Cloud CLI

Alibaba Cloud CLI mengintegrasikan ossutil, antarmuka baris perintah (CLI) untuk Object Storage Service (OSS). Integrasi ini memungkinkan Anda mengelola sumber daya OSS dalam lingkungan CLI yang terpadu. Topik ini menjelaskan cara menggunakan ossutil dengan Alibaba Cloud CLI.

Latar Belakang

ossutil memungkinkan Anda mengelola data OSS dari sistem Windows, Linux, atau macOS. Ini diintegrasikan sebagai plugin ke dalam Alibaba Cloud CLI. Anda dapat memanggil ossutil langsung dari Alibaba Cloud CLI untuk mengelola sumber daya inti OSS, seperti bucket dan objek.
Mulai dari versi 3.0.304, Alibaba Cloud CLI mengintegrasikan <a baseurl="t3144192_v1_0_0.xdita" data-node="4930824" data-root="39083" data-tag="xref" href="t2720201.xdita#" id="cf22035ef1brd">ossutil 2.0</a> untuk memberikan pengalaman pengguna yang lebih stabil dan efisien. Alat ini kompatibel dengan baik ossutil 1.0 maupun ossutil 2.0, dan perintah ossutil 1.0 masih dapat digunakan. Kami menyarankan Anda untuk memutakhirkan Alibaba Cloud CLI ke versi terbaru untuk memanfaatkan semua fitur baru dan peningkatan performa dari ossutil 2.0.

Perbedaan utama antara ossutil 1.0 dan ossutil 2.0 di Alibaba Cloud CLI adalah sebagai berikut:

Perbedaan Pemanggilan Perintah

Perintah telah ditingkatkan dari oss menjadi ossutil di versi baru, yang lebih baik membedakan modul fitur dan mendukung fitur lanjutan yang lebih banyak.

Versi	Format Perintah
ossutil 1.0	`aliyun oss`
ossutil 2.0	`aliyun ossutil`

Catatan

Perintah berubah dari oss menjadi ossutil di versi baru. Jika Anda ingin menggunakan ossutil 2.0, Anda harus memperbarui perintah di skrip atau tugas otomatis Anda.

Perbedaan Perintah

Item	ossutil 1.0	ossutil 2.0
Konfigurasi Bucket	Dikategorikan berdasarkan fitur di bawah perintah root, seperti logging dan lifecycle.	Setiap perintah sesuai dengan satu Operasi API dan ditempatkan di bawah subperintah ossutil api. Parameter konfigurasi mendukung format XML dan JSON. Mendukung konversi format untuk konten keluaran, seperti mengonversi keluaran ke JSON.
Perintah rm	Mendukung penghapusan bucket. Mendukung penghapusan beberapa jenis data dalam satu operasi, seperti menghapus objek dan bagian secara bersamaan. Contoh: `rm oss://bucket/prefix -r -f -m`	Tidak mendukung penghapusan bucket. Untuk menghapus bucket, Anda dapat menggunakan perintah rb baru. Mendukung penghapusan hanya satu jenis data dalam satu operasi. Misalnya, untuk menghapus objek dan bagian, Anda harus memanggil perintah secara terpisah. Contoh: `rm oss://bucket/prefix -r -f` dan `rm oss://bucket/prefix -m -r -f`.
Perintah Append	Perintahnya adalah appendfromfile. Sumber data hanya mendukung jalur lokal.	Perintahnya adalah append. Sumber data mendukung jalur lokal, jalur OSS, dan input standar.
Perintah cat	Hanya mendukung output seluruh isi objek.	Mendukung output sebagian objek, seperti 10 byte pertama atau 10 byte terakhir.
Perintah cp	Pengopian antar objek hanya menyalin data, bukan metadata atau tag.	Saat Anda menyalin antar objek, Anda dapat menggunakan --copy-props untuk mengontrol aturan replikasi untuk metadata dan tag: tidak menyalin, menyalin metadata, atau menyalin metadata dan tag. Secara default, metadata dan tag disalin.
Ubah atribut objek (ACL, kelas penyimpanan, metadata, dan tag).	Gunakan perintah set-acl untuk mengubah ACL objek. Gunakan perintah set-meta untuk mengubah metadata objek. Gunakan perintah cp untuk mengubah kelas penyimpanan dan tag objek. Gunakan perintah object-tagging untuk mengubah tag objek.	Perintah modifikasi atribut objek digabungkan menjadi satu perintah: set-props. Anda dapat memilih Operasi API yang sesuai berdasarkan parameter atribut yang perlu Anda ubah untuk membuat perubahan atribut lebih efisien. Mendukung set-acl dan set-meta melalui alias, tetapi parameter baris perintahnya berbeda dari perintah aslinya. Mendukung instruksi modifikasi metadata dan tag yang kaya, seperti replace, update, purge, dan delete.
Presigning	Perintah untuk menghasilkan URL yang ditandatangani adalah sign. Waktu kedaluwarsa tanda tangan hanya mendukung interval waktu, seperti 120 detik.	Perintah untuk menghasilkan URL yang ditandatangani adalah presign. Mendukung alias sign, tetapi parameter baris perintahnya berbeda dari perintah aslinya. Waktu kedaluwarsa tanda tangan mendukung interval waktu, seperti 120 detik, dan pengaturan waktu absolut. Untuk tanda tangan V4, periode validitas maksimum untuk URL yang ditandatangani adalah 7 hari.
Pemulihan Versi	Mendukung pemulihan hanya versi objek terbaru dengan menghapus penanda hapus.	Mendukung pemulihan versi objek terbaru dengan menghapus penanda hapus. Mendukung pemulihan ke versi objek tertentu berdasarkan ID versi dengan menyalin versi objek yang dimaksud. Mendukung pemulihan ke versi objek tertentu berdasarkan waktu dengan menyalin versi objek.
Hash	Mendukung penghitungan hash hanya untuk file lokal.	Mendukung penghitungan hash file lokal, jalur objek, dan operasi batch.
sync	Tanpa parameter --delete, efeknya sama dengan perintah cp. Pemindaian rentang sumber dan menyalin data secara bersamaan, tanpa batas jumlah maksimum. Dengan parameter --delete, fase replikasi data juga menggunakan mode pemindaian-dan-penyalinan.	Tanpa memperhatikan apakah parameter --delete diatur, batas maksimum kuantitas diberlakukan. Secara default adalah 1 juta, dan maksimum dapat dikonfigurasi hingga 5 juta. Pertama-tama, ia memindai daftar sumber dan tujuan, menyinkronkan data, lalu menghapus file tujuan berdasarkan opsi --delete. Ini memberikan performa sinkronisasi yang lebih baik ketika digabungkan dengan opsi --update atau --size-only.

Perbedaan Opsi

Item	ossutil 1.0	ossutil 2.0
--include --exclude	Hanya mendukung pencocokan nama objek atau file. Jika beberapa aturan "include" dan "exclude" ditentukan, setiap aturan diterapkan secara berurutan dari kiri ke kanan hingga kecocokan akhir ditentukan.	Mendukung pencocokan nama objek atau file. Mendukung pencocokan jalur objek atau file. Jika beberapa aturan "include" dan "exclude" ditentukan, aturan diterapkan secara berurutan dari kiri ke kanan. Jika suatu aturan (include atau exclude) cocok, pemeriksaan berikutnya dihentikan segera.
--snapshot-path	Didukung	Tidak didukung
--encoding-type	Berlaku untuk parameter input dan output.	Pada perintah tingkat tinggi, parameter ini hanya berlaku untuk parameter input, bukan hasil output. Pada perintah tingkat API, arti parameter ini konsisten dengan parameter yang sesuai dari Operasi API.
Opsi pengecualian untuk tujuan	Hanya mendukung --update.	Mendukung --update, --size-only, --checksum, dan --ignore-existing.
Batas kecepatan	Hanya mendukung batas kecepatan unggah menggunakan opsi --max-speed.	Mendukung batas kecepatan unggah dan unduh menggunakan opsi --bandwidth-limit.
Konfigurasi default
Algoritma tanda tangan	Menggunakan algoritma tanda tangan V1.	Menggunakan algoritma tanda tangan V4. Saat menggunakan algoritma tanda tangan V4, periode validitas maksimum adalah satu minggu.
Protokol HTTPS	Jika tidak ditentukan, protokol HTTP digunakan secara default.	Jika tidak ditentukan, protokol HTTPS digunakan secara default.
API daftar objek	Menggunakan operasi API ListObjects.	Menggunakan operasi API ListObjectsV2 secara default. Anda dapat beralih ke operasi API ListObjects menggunakan opsi --list-objects.
Timeout baca/tulis klien	Nilai default adalah 1.200 detik.	Timeout default adalah 20 detik.
Timeout koneksi klien	Timeout koneksi klien default adalah 120 detik.	Timeout koneksi klien default adalah 10 detik.
Unggah berkelanjutan	Unggah berkelanjutan diaktifkan secara default.	Unggah berkelanjutan dinonaktifkan secara default.

ossutil 2.0

Catatan

Di versi terbaru Alibaba Cloud CLI, ossutil 2.0 mendukung pemeriksaan otomatis dan peningkatan ke versi terbaru. Anda tidak perlu menjalankan perintah update.
Versi ossutil 2.0 independen dari versi Alibaba Cloud CLI. Pembaruan tidak bergantung pada versi CLI.

Sintaksis

Sintaksis perintah untuk ossutil 2.0 di Alibaba Cloud CLI adalah sebagai berikut:

aliyun ossutil command [argument] [flags]

aliyun ossutil command subcommond [argument] [flags]  

aliyun ossutil topic

argument: parameter, yang merupakan string.
flags: opsi. Mendukung gaya nama pendek -o[=value]/ -o [value] dan gaya nama panjang --options[=value]/--options[value]. Jika Anda menentukan opsi eksklusif beberapa kali, hanya nilai terakhir yang berlaku.

Berikut adalah contoh perintah:

Perintah: aliyun ossutil cat oss://bucket/object
Perintah multi-level: aliyun ossutil api get-bucket-cors --bucket bucketexample
Perintah bantuan: aliyun ossutil filter

Perintah

ossutil 2.0 menyediakan tiga jenis perintah: perintah tingkat tinggi, perintah tingkat API, dan perintah bantu.

Perintah tingkat tinggi: Digunakan untuk operasi umum pada objek atau bucket, seperti membuat dan menghapus bucket, menyalin data, dan memodifikasi atribut objek.

Perintah	Deskripsi
mb	Membuat bucket.
rb	Menghapus bucket.
du	Meminta ukuran bucket atau direktori (prefix).
stat	Menampilkan deskripsi bucket atau objek.
mkdir	Membuat objek yang namanya diakhiri dengan karakter `/`.
append	Menambahkan konten ke akhir objek yang dapat ditambahkan.
cat	Mengirimkan isi objek ke output standar.
ls	Menampilkan bucket atau objek.
cp	Mengunggah, mengunduh, atau menyalin objek.
rm	Menghapus objek.
set-props	Menetapkan atribut objek.
presign	Menghasilkan URL yang ditandatangani untuk objek.
restore	Memulihkan objek yang dibekukan.
revert	Mengembalikan objek ke versi tertentu.
sync	Menyinkronkan direktori atau objek dari sumber ke tujuan.
hash	Menghitung hash dari file atau objek.

Perintah tingkat API: Memberikan akses langsung ke Operasi API dan mendukung parameter konfigurasi dari Operasi API yang sesuai.

Perintah	Deskripsi
put-bucket-acl	Menetapkan atau memodifikasi ACL bucket.
get-bucket-acl	Meminta ACL bucket.
....
put-bucket-cors	Membuat aturan berbagi sumber daya lintas asal (CORS).
get-bucket-cors	Meminta aturan CORS.
delete-bucket-cors	Menghapus aturan CORS.
...

Perintah bantu: Digunakan untuk tugas-tugas seperti mengonfigurasi file dan mengakses informasi bantuan tambahan.
Perintah
Deskripsi
help
Mendapatkan informasi bantuan.
config
Membuat file konfigurasi untuk menyimpan item konfigurasi dan kredensial akses.
version
Menampilkan versi ossutil.
probe
Menjalankan tugas probe.

Opsi baris perintah

Opsi baris perintah di ossutil 2.0 dibagi menjadi opsi global dan lokal. Opsi global berlaku untuk semua perintah. Opsi lokal hanya berlaku untuk perintah tertentu. Opsi baris perintah memiliki prioritas tertinggi dan dapat menimpa parameter yang ditetapkan dalam file konfigurasi atau variabel lingkungan.

Opsi baris perintah kueri

Jalankan perintah berikut untuk menanyakan opsi baris perintah:

ossutil cp -h

Keluaran perintah:

Flags:
      --acl string                         Daftar kontrol akses (ACL) objek, nilai valid: "private","public-read","public-read-write","default"
      --bandwidth-limit SizeSuffix         Batas bandwidth dalam B/s, atau gunakan akhiran B|K|M|G|T|P
      --bigfile-threshold SizeSuffix       Ambang ukuran file, file dengan ukuran lebih besar dari ambang akan menggunakan unggah multipart, unduhan atau salinan, atau gunakan akhiran B|K|M|G|T|P (default 100Mi)
      --cache-control string               Perilaku caching halaman web saat objek diunduh
      --checkers int                       Jumlah pemeriksa yang berjalan secara paralel (default 16)
      --checkpoint-dir string              Direktori yang ditentukan untuk informasi kelanjutan titik henti
      --checksum                           Hanya menyalin file sumber dengan ukuran dan checksum berbeda (jika tersedia)
      --content-disposition string         Metode yang digunakan untuk mengakses objek
      --content-encoding string            Metode yang digunakan untuk mengkodekan objek
      --content-type string                Tipe mime objek
      --copy-props string                  Menentukan properti mana yang disalin dari objek sumber, nilai valid: "none","metadata","default"
  -d, --dirs                               Mengembalikan nama subdirektori yang cocok alih-alih isi subdirektori
      --encoding-type string               Jenis pengkodean nama objek atau nama file yang dimasukkan pengguna, nilai valid: "url"
      --end-with string                    Nama objek tempat operasi daftar berakhir, termasuk
      --exclude stringArray                Kecualikan file yang cocok dengan pola
      --exclude-from stringArray           Baca pola pengecualian dari file
      --expires string                     Waktu kedaluwarsa cache dalam UTC
      --files-from stringArray             Baca daftar nama file sumber dari file, abaikan baris kosong dan komentar
      --files-from-raw stringArray         Baca daftar nama file sumber dari file tanpa pemrosesan apa pun pada baris
      --filter stringArray                 Aturan penyaringan file
      --filter-from stringArray            Baca aturan penyaringan file dari file
  -f, --force                              Operasi diam-diam tanpa meminta pengguna untuk mengonfirmasi operasi
      --ignore-existing                    Lewati semua file yang sudah ada di tujuan
      --include stringArray                Jangan kecualikan file yang cocok dengan pola
      --include-from stringArray           Baca pola inklusi dari file
  -j, --job int                            Jumlah tugas konkurensi antar multi-file (default 3)
      --list-objects                       Gunakan ListObjects alih-alih ListObjectsV2 untuk mendaftar objek
      --max-age Duration                   Jangan transfer file apa pun yang lebih tua dari ini, dalam s atau akhiran ms|s|m|h|d|w|M|y (default off)
      --max-mtime Time                     Jangan transfer file apa pun yang lebih baru dari ini, format waktu UTC (default off)
      --max-size SizeSuffix                Jangan transfer file apa pun yang lebih besar dari ukuran, dalam B atau akhiran B|K|M|G|T|P, 1K(KiB)=1024B
      --metadata strings                   Menentukan metadata pengguna objek, dalam format key=value
      --metadata-directive string          Metode yang digunakan untuk mengonfigurasi metadata objek tujuan, nilai valid: "COPY","REPLACE"
      --metadata-exclude stringArray       Kecualikan metadata yang cocok dengan pola
      --metadata-filter stringArray        Aturan penyaringan metadata
      --metadata-filter-from stringArray   Baca aturan penyaringan metadata dari file
      --metadata-include stringArray       Jangan kecualikan metadata yang cocok dengan pola
      --min-age Duration                   Jangan transfer file apa pun yang lebih baru dari ini, dalam s atau akhiran ms|s|m|h|d|w|M|y (default off)
      --min-mtime Time                     Jangan transfer file apa pun yang lebih tua dari ini, format waktu UTC (default off)
      --min-size SizeSuffix                Jangan transfer file apa pun yang lebih kecil dari ukuran, dalam B atau akhiran B|K|M|G|T|P, 1K(KiB)=1024B
      --no-error-report                    Jangan menghasilkan file laporan kesalahan selama operasi batch
      --no-progress                        Kemajuan tidak ditampilkan
      --output-dir string                  Menentukan direktori untuk menempatkan file keluaran, file keluaran berisi: file laporan kesalahan yang dihasilkan selama operasi batch (default "ossutil_output")
      --page-size int                      Jumlah hasil yang dikembalikan dalam setiap respons terhadap operasi daftar (default 1000), dalam rentang 1 - 1000
      --parallel int                       Jumlah tugas konkurensi saat bekerja dengan file
      --part-size SizeSuffix               Ukuran bagian, dihitung ukuran yang sesuai berdasarkan ukuran file secara default, atau gunakan akhiran B|K|M|G|T|P, dalam rentang 100Ki - 5Gi
  -r, --recursive                          Operasi rekursif, jika opsi ini ditentukan, perintah akan beroperasi pada semua objek yang cocok di bawah bucket, jika tidak, beroperasi pada objek tunggal.
      --request-payer string               Pembayar permintaan. Tetapkan nilai ini jika Anda ingin membayar untuk pemohon, nilai valid: "requester"
      --size-only                          Hanya menyalin file sumber dengan ukuran berbeda
      --start-after string                 Nama objek tempat operasi daftar dimulai, tidak termasuk
      --storage-class string               Kelas penyimpanan objek, nilai valid: "Standard","IA","Archive","ColdArchive","DeepColdArchive"
      --tagging strings                    Menentukan tag objek tujuan, dalam format key=value
      --tagging-directive string           Metode yang digunakan untuk mengonfigurasi tag untuk objek tujuan, nilai valid: "COPY","REPLACE"
  -u, --update                             Hanya menyalin ketika file sumber lebih baru daripada file tujuan

Global Flags:
  -i, --access-key-id string        AccessKeyID saat mengakses OSS
  -k, --access-key-secret string    AccessKeySecret saat mengakses OSS
      --addressing-style string     Gaya pengalamatan endpoint (default "virtual"), nilai valid: "virtual","path","cname"
      --cloudbox-id string          ID CloudBox. Berlaku untuk skenario CloudBox
  -c, --config-file string          Jalur file konfigurasi (default "~/.ossutilconfig")
      --connect-timeout int         Timeout koneksi klien dalam detik (default 10)
  -n, --dry-run                     Lakukan uji coba tanpa perubahan permanen
  -e, --endpoint string             Nama domain yang dapat digunakan layanan lain untuk mengakses OSS.
  -h, --help                        bantuan untuk perintah
      --language string             Bahasa teks tampilan
      --log-file string             Menentukan file output log. Saat -, output ke Stdout
      --loglevel string             Tingkat pesan debug (default "off"), nilai valid: "off","info","debug"
      --mode string                 Menentukan mode otentikasi, nilai valid: "AK","StsToken","EcsRamRole","Anonymous"
      --output-format string        Gaya pemformatan untuk output perintah (default "raw")
      --output-properties strings   Properti format output
      --output-query string         Kondisi kueri JMESPath untuk digunakan dalam menyaring data respons
      --profile string              Profil spesifik dari file konfigurasi Anda.
      --proxy string                Menentukan server proxy. Saat 'env', gunakan variabel lingkungan HTTP_PROXY dan HTTPS_PROXY
  -q, --quiet                       Mode tenang, cetak sesedikit mungkin
      --read-timeout int            Timeout permintaan baca/tulis klien. Satuan: detik. Nilai default: 20.
      --region string               Wilayah tempat pusat data berada. Contoh: cn-hangzhou.
      --retry-times int             Jumlah percobaan ulang saat terjadi kesalahan. Nilai default: 10.
      --role-arn string             Menentukan ARN peran
      --role-session-name string    Menentukan nama sesi
      --sign-version string         Versi algoritma tanda tangan (default "v4"), nilai valid: "v1","v4"
      --skip-verify-cert            Menentukan bahwa file sertifikat digital yang disediakan oleh server tidak diverifikasi
  -t, --sts-token string            Token STS saat mengakses OSS

Gunakan opsi baris perintah

Dalam operasi baris perintah, beberapa perintah memerlukan parameter tambahan untuk menentukan objek operasi atau mengatur opsi. Untuk perintah yang memerlukan parameter, Anda harus memberikan nilai parameter yang sesuai untuk mencapai fungsi yang dimaksudkan. Sebagai contoh:

ossutil ls --profile dev

Perintah ossutil ls --profile dev memungkinkan pengguna menentukan file konfigurasi tertentu menggunakan nilai parameter dev. Opsi dengan parameter biasanya memerlukan spasi atau tanda sama dengan (=) untuk memisahkan nama opsi dari nilai parameter, seperti --profile dev atau --profile=dev. Jika nilai parameter berisi spasi, Anda harus mengapit seluruh nilai dalam tanda kutip ganda untuk memastikan bahwa perintah diparsing dengan benar, seperti --description "Daftar bucket OSS".

Opsi baris perintah global

Opsi	Tipe	Deskripsi
-i, --access-key-id	string	ID AccessKey yang digunakan untuk mengakses OSS.
-k, --access-key-secret	string	Rahasia AccessKey yang digunakan untuk mengakses OSS.
--addressing-style	string	Gaya pengalamatan. Nilai valid: virtual (default): mode hosting virtual. path: mode jalur. cname: mode nama domain kustom.
-c, --config-file	string	Jalur file konfigurasi. Nilai default: `~\\.ossutilconfig`.
--connect-timeout	int	Timeout koneksi klien dalam detik. Nilai default: 10. Satuan: detik.
-n, --dry-run	/	Melakukan uji coba tanpa membuat perubahan.
-e, --endpoint	string	Endpoint wilayah.
-h, --help	/	Menampilkan informasi bantuan untuk perintah tertentu.
--language	string	Bahasa tampilan.
--loglevel	string	Tingkat log. Nilai valid: off (default) info debug
--mode	string	Mode otentikasi. Nilai valid: AK: pasangan AccessKey. StsToken: kredensial akses sementara. EcsRamRole: peran RAM yang dilampirkan ke instans Elastic Compute Service (ECS). Anonymous: akses anonim.
--output-format	string	Format output. Nilai default: raw.
--output-query	string	Kondisi kueri JMESPath.
--profile	string	Menentukan profil dalam file konfigurasi.
-q, --quiet	/	Mengaktifkan mode tenang untuk mencetak informasi sesedikit mungkin.
--read-timeout	int	Timeout permintaan baca/tulis klien. Satuan: detik. Nilai default: 20.
--region	string	Wilayah tempat pusat data berada. Contoh: cn-hangzhou.
--retry-times	int	Jumlah percobaan ulang saat terjadi kesalahan. Nilai default: 10.
--sign-version	string	Versi algoritma tanda tangan. Nilai valid: v1 v4 (default)
--skip-verify-cert	/	Menentukan bahwa sertifikat digital yang diberikan oleh server tidak diverifikasi.
-t, --sts-token	string	Token Layanan Keamanan (STS) yang digunakan untuk mengakses OSS.
--proxy	string	Server proxy. Metode konfigurasi: Konfigurasi langsung: Anda dapat langsung menentukan server proxy. Contoh: `http://proxy.example.com:8080` `https://proxy.example.com:8443` `env`: gunakan variabel lingkungan `HTTP_PROXY` dan `HTTPS_PROXY` untuk mendapatkan informasi server proxy. Anda perlu mengonfigurasi variabel lingkungan ini di sistem operasi. Contoh: `HTTP_PROXY=http://proxy.example.com:8080` `HTTPS_PROXY=https://proxy.example.com:8443` Setelah Anda mengonfigurasi variabel lingkungan ini, Anda dapat menetapkan nilai opsi server proxy ke `env`. Kemudian, sistem secara otomatis menggunakan pengaturan proxy yang ditentukan oleh variabel lingkungan ini.
--log-file	string	File output log. Nilai valid: `-`: Log diekspor ke stdout. `Jalur file`: Setelah Anda menentukan jalur file tertentu, log diekspor ke file tersebut. Jika Anda tidak menentukan jalur file tertentu, log diekspor ke file konfigurasi default.
--cloudbox-id	string	ID CloudBox. Ini berlaku untuk skenario CloudBox.

Tipe Opsi

Tipe	Opsi	Deskripsi
String	--option string	Argumen string dapat berisi huruf, angka, simbol, dan spasi dalam set karakter ASCII. Jika string berisi spasi, apit dengan tanda kutip. Contoh: --acl private
Boolean	--option	Menghidupkan atau mematikan opsi. Contoh: --dry-run
Integer	--option Int	Opsi mengambil integer tanpa tanda sebagai nilainya. Contoh: --read-timeout 10
Timestamp	--option Time	Timestamp (DateTime atau Date) dalam format ISO 8601. Contoh: --max-mtime 2006-01-02T15:04:05
Akhiran ukuran	--option SizeSuffix	Satuan ukuran. Satuan default adalah B. Satuan lainnya termasuk K (KiB), M (MiB), G (GiB), T (TiB), P (PiB), dan E (EiB). Sebagai contoh, ukuran minimum 1024 byte dapat ditentukan sebagai: --min-size 1024 --min-size 1K
Satuan waktu	--option Duration	Satuan waktu. Satuan default adalah detik (s). Satuan waktu yang didukung adalah milidetik (ms), detik (s), menit (m), jam (h), hari (d), minggu (w), bulan (M), dan tahun (y). Nilai numerik bisa berupa desimal. Sebagai contoh, satuan waktu minimum 1,5 hari dapat ditentukan sebagai: --min-age 1.5d
Daftar string	--option strings	Anda dapat menentukan opsi sekali atau beberapa kali dalam perintah. Anda dapat menentukan satu nilai atau beberapa nilai dipisahkan koma untuk setiap kemunculan opsi. Contoh: --metadata user=jack,email=ja**@test.com --metadata address=china
Array string	--option stringArray	Anda dapat menentukan opsi sekali atau beberapa kali dalam perintah. Anda hanya dapat menentukan satu nilai untuk setiap kemunculan opsi. Contoh: --include .jpg --include .txt

Memuat data dari file

Dalam banyak kasus, Anda menentukan nilai parameter langsung di baris perintah. Saat Anda perlu memproses nilai kompleks, memuat nilai dari file memberikan lebih banyak efisiensi. Saat Anda merangkai perintah, Anda harus menentukan nilai parameter dengan menggunakan input standar. Saat parameter dapat mengambil nilai dengan menggunakan metode berbeda:

Jika nilai dimulai dengan file://, data dimuat dari file yang ditentukan.
Jika nilai adalah -, data dimuat dari input standar.

Sebagai contoh, Anda ingin membuat aturan CORS, yang dikonfigurasikan dalam format JSON. Perintah sampel berikut membuat aturan CORS dengan memuat konfigurasi CORS dari file cors-configuration.json:

{
  "CORSRule": {
    "AllowedOrigin": ["www.aliyun.com"],
    "AllowedMethod": ["PUT","GET"],
    "MaxAgeSeconds": 10000
  }
}

aliyun ossutil api put-bucket-cors --bucket examplebucket --cors-configuration file://cors-configuration.json

Perintah sampel berikut membuat aturan CORS dengan mengambil data konfigurasi JSON di baris perintah:

{"CORSRule":{"AllowedOrigin":["www.aliyun.com"],"AllowedMethod":["PUT","GET"],"MaxAgeSeconds":10000}}

aliyun ossutil api put-bucket-cors --bucket examplebucket --cors-configuration  "{\"CORSRule\":{\"AllowedOrigin\":[\"www.aliyun.com\"],\"AllowedMethod\":[\"PUT\",\"GET\"],\"MaxAgeSeconds\":10000}}"

Perintah sampel berikut membuat aturan CORS dengan mengambil konfigurasi dari input standar:

cat cors-configuration.json | aliyun ossutil api put-bucket-cors --bucket examplebucket --cors-configuration -

Keluaran perintah kontrol

Format keluaran

Anda dapat menggunakan parameter --output-format dalam perintah du, stat, dan ls serta subperintah dari perintah api untuk memformat keluaran. Tabel berikut menjelaskan nilai valid dari opsi --output-format.

Format	Deskripsi
raw	Mengembalikan keluaran dalam format mentah, yaitu format di mana server mengembalikan konten.
json	Mengembalikan keluaran dalam format JSON.
yaml	Mengembalikan keluaran dalam format YAML.

Pada contoh berikut, output perintah get-bucket-cors dalam format raw:

aliyun ossutil api get-bucket-cors --bucket bucketexample
<?xml version="1.0" encoding="UTF-8"?>
<CORSConfiguration>
  <CORSRule>
    <AllowedOrigin>www.aliyun.com</AllowedOrigin>
    <AllowedMethod>PUT</AllowedMethod>
    <AllowedMethod>GET</AllowedMethod>
    <MaxAgeSeconds>10000</MaxAgeSeconds>
  </CORSRule>
  <ResponseVary>false</ResponseVary>
</CORSConfiguration>

Contoh keluaran diformat dalam JSON:

aliyun ossutil api get-bucket-cors --bucket bucketexample --output-format json
{
  "CORSRule": {
    "AllowedMethod": [
      "PUT",
      "GET"
    ],
    "AllowedOrigin": "www.aliyun.com",
    "MaxAgeSeconds": "10000"
  },
  "ResponseVary": "false"
}

Filter keluaran

ossutil menyediakan mekanisme query keluaran berbasis JSON bawaan. Anda dapat menggunakan opsi --output-query value untuk menanyakan keluaran.

Catatan

Opsi ini hanya berlaku untuk subperintah dalam set perintah API.

Fitur query keluaran didasarkan pada JMESPath. Saat Anda menggunakan fitur query keluaran, keluaran diformat dalam JSON, disaring berdasarkan ekspresi query JMESPath, dan dikembalikan dalam format yang ditentukan. Untuk informasi lebih lanjut tentang JMEPath, lihat Spesifikasi JMESPath.

Dalam contoh berikut, perintah get-bucket-cors hanya mengembalikan nilai parameter AllowedMethod:

aliyun ossutil api get-bucket-cors --bucket bucketexample --output-query CORSRule.AllowedMethod --output-format json
[
  "PUT",
  "GET"
]

Tampilan yang mudah dibaca manusia

ossutil menyediakan opsi --human-readable yang memungkinkan ukuran data dan jumlah dalam keluaran perintah du dan stat ditampilkan dengan cara yang lebih mudah dibaca manusia. Secara khusus, ukuran data ditampilkan dalam KiB, MiB, GiB, TiB, dan PiB berbasis 1024, dan jumlah ditampilkan dengan menggunakan singkatan unit berbasis 1000 seperti k, m, g, t, dan p.

Contoh mode mentah

aliyun ossutil stat oss://bucketexample
ACL                         : private
AccessMonitor               : Disabled
ArchiveObjectCount          : 2
ArchiveRealStorage          : 10
ArchiveStorage              : 131072
...
StandardObjectCount         : 119212
StandardStorage             : 66756852803
Storage                     : 66756852813
StorageClass                : Standard
TransferAcceleration        : Disabled

Contoh mode yang mudah dibaca manusia

aliyun ossutil stat oss://bucketexample --human-readable
ACL                         : private
AccessMonitor               : Disabled
ArchiveObjectCount          : 2
ArchiveRealStorage          : 10
ArchiveStorage              : 131.072k
...
StandardObjectCount         : 119.212k
StandardStorage             : 66.757G
Storage                     : 66.757G
StorageClass                : Standard
TransferAcceleration        : Disabled

Kode pengembalian perintah

Saat panggilan ke ossutil dilakukan dengan menggunakan proses, informasi echo tidak dapat ditampilkan secara real time. Saat proses selesai, kode pengembalian ditampilkan berdasarkan hasilnya. Anda dapat menjalankan perintah berikut untuk menampilkan kode pengembalian untuk perintah yang sebelumnya dieksekusi dan menggunakan kode pengembalian untuk pemecahan masalah.

Linux

Jalankan perintah echo $? untuk menampilkan kode pengembalian perintah yang sebelumnya dieksekusi.

Windows

Jalankan perintah echo %errorlevel% untuk menampilkan kode pengembalian perintah yang sebelumnya dieksekusi.

macOS

Jalankan perintah echo $? untuk menampilkan kode pengembalian perintah yang sebelumnya dieksekusi.

Kode Pengembalian	Deskripsi
0	Menunjukkan keberhasilan. Permintaan yang dikirim ke server berhasil ditangani dan server mengembalikan kode status 200.
1	Menunjukkan kesalahan parameter. Misalnya, subperintah atau parameter yang diperlukan hilang, atau perintah atau parameter tidak dikenal.
2	Menunjukkan kesalahan server. Perintah berhasil mengirim permintaan ke server, tetapi server mengembalikan kesalahan (kode status selain 2xx).
3	Menunjukkan kesalahan bukan di sisi server selama pemanggilan ke OSS SDK for Go.
4	Menunjukkan kegagalan sebagian dalam pemrosesan batch, misalnya, dengan menggunakan perintah cp atau rm.
5	Menunjukkan interupsi. Perintah dibatalkan dengan menggunakan `Ctrl`+`C`.

Contoh

Contoh 1: Unggah file lokal upload.rar ke bucket bernama bucket dengan kecepatan 20 MB/s. Satuan default adalah byte per detik (B/s).
```
aliyun ossutil cp D:\\upload.rar oss://bucket/ --bandwidth-limit 20971520
```
Contoh 2: Unggah file lokal file.rar ke bucket bernama bucket dengan kecepatan 50 MB/s. Satuan yang ditentukan adalah megabyte per detik (MB/s).
```
aliyun ossutil cp D:\\file.rar oss://bucket/dir -r --bandwidth-limit 50M
```
Contoh 3: Unduh objek download.rar dari bucket bernama bucket ke direktori saat ini dan batasi kecepatan unduhan hingga 20 MB/s.
```
aliyun ossutil cp oss://bucket/download.rar . --bandwidth-limit 20971520
```

ossutil 1.0

Sintaksis

aliyun oss [command] [args...] [options...]

Perintah

Perintah	Deskripsi
access-monitor	Menentukan status pelacakan akses dari sebuah bucket.
appendfromfile	Menambahkan konten ke objek yang dapat ditambahkan yang telah diunggah.
bucket-cname	Menampilkan konfigurasi CNAME dari sebuah bucket.
bucket-encryption	Menambah, memodifikasi, menanyakan, atau menghapus konfigurasi enkripsi dari sebuah bucket.
bucket-policy	Menambah, memodifikasi, menanyakan, atau menghapus konfigurasi Kebijakan bucket dari sebuah bucket.
bucket-tagging	Menambah, memodifikasi, menanyakan, atau menghapus konfigurasi tag dari sebuah bucket.
bucket-versioning	Menambahkan atau menanyakan konfigurasi pengendalian versi dari sebuah bucket.
cat	Mengeluarkan isi objek ke ossutil.
config	Membuat file konfigurasi untuk menyimpan informasi akses OSS.
cors	Menambah, memodifikasi, menanyakan, atau menghapus konfigurasi CORS dari sebuah bucket.
cors-options	Menguji apakah sebuah bucket mengizinkan permintaan akses lintas domain tertentu.
cp	Mengunggah, mengunduh, atau menyalin file.
create-symlink	Membuat tautan simbolik.
du	Memeriksa penggunaan penyimpanan bucket, objek, atau direktori yang ditentukan.
getallpartsize	Memeriksa ukuran setiap bagian dari tugas unggah multi-bagian yang belum selesai di dalam bucket dan total ukuran bagian-bagian tersebut.
hash	Menghitung hash CRC-64 atau MD5 dari sebuah file lokal.
bantuan	Meminta informasi bantuan tentang suatu perintah. Jika Anda tidak yakin cara menggunakan suatu perintah, gunakan perintah help untuk mendapatkan informasi bantuan mengenai perintah tersebut.
inventory	Menambahkan konfigurasi inventaris ke bucket, atau menanyakan, mendaftar, menghapus konfigurasi inventaris dari bucket.
siklus hidup	Menambahkan konfigurasi siklus hidup ke sebuah bucket, atau memodifikasi, menanyakan, menghapus konfigurasi siklus hidup dari sebuah bucket.
listpart	Menyebutkan bagian-bagian yang dihasilkan dalam tugas unggah multi-bagian yang belum selesai yang dimulai untuk sebuah objek.
pencatatan	Menambahkan konfigurasi logging ke sebuah bucket, atau memodifikasi, menanyakan, menghapus konfigurasi logging dari sebuah bucket.
lrb	Menyebutkan bucket yang berada di satu wilayah atau beberapa wilayah.
ls	Menampilkan daftar bucket, objek, atau bagian.
mb	Buat sebuah bucket.
mkdir	Membuat direktori di dalam sebuah bucket.
object-tagging	Menambahkan konfigurasi tagging ke sebuah bucket, atau memodifikasi, menanyakan, menghapus konfigurasi tagging dari sebuah objek.
probe	Memantau akses ke OSS. Anda juga dapat menjalankan perintah ini untuk memecahkan masalah yang disebabkan oleh Titik kegagalan jaringan atau pengaturan parameter yang tidak benar selama proses unggah dan unduh.
read-symlink	Membaca deskripsi dari sebuah tautan simbolik.
referer	Menambahkan konfigurasi Perlindungan hotlink ke sebuah bucket, atau memodifikasi, menanyakan, menghapus konfigurasi Perlindungan hotlink dari sebuah bucket.
replikasi	Mengelola konfigurasi Replikasi Lintas Wilayah (Cross-Region Replication/CRR) dari sebuah bucket.
request-payment	Mengonfigurasi mode bayar-per-permintaan atau menanyakan konfigurasi bayar-per-permintaan dari sebuah bucket.
resource-group	Mengonfigurasi kelompok sumber daya untuk bucket dan menanyakan informasi tentang kelompok sumber daya tersebut.
memulihkan	Memulihkan objek dari status beku ke status yang dapat dibaca.
revert-versioning	Memulihkan objek yang dihapus ke versi terbaru dari objek tersebut.
rm	Menghapus bucket, objek, atau bagian.
set-acl	Mengonfigurasi ACL untuk sebuah bucket atau objek.
set-meta	Menetapkan metadata dari objek yang diunggah.
Tanda tangani	Menghasilkan URL yang ditandatangani untuk sebuah objek dan membagikan URL yang ditandatangani tersebut kepada pihak ketiga untuk diunduh atau dilihat pratinjau.
stat	Mendapatkan deskripsi dari bucket atau objek yang ditentukan.
gaya	Mengonfigurasi gaya citra untuk sebuah bucket.
sync	Menyinkronkan file lokal ke OSS, objek OSS ke disk lokal, atau objek antara jalur-jalur OSS.
memperbarui	Memperbarui versi ossutil.
situs web	Menambahkan konfigurasi hosting situs web statis, pengalihan, atau kembali-ke-asal ke bucket, atau memodifikasi, menanyakan, menghapus konfigurasi hosting situs web statis, pengalihan, atau kembali-ke-asal bucket.
worm	Menanyakan kebijakan retensi yang dikonfigurasikan untuk bucket.

Contoh

Contoh 1: Buat bucket bernama vmeixme dan atur kelas penyimpanan bucket menjadi Standard.
```
aliyun oss mb oss://vmeixme --storage-class Standard
```
Contoh 2: Anda dapat membuat folder bernama horse dalam bucket.
```
aliyun oss mkdir oss://vmeixme/horse/
```
Contoh 3: Daftar sumber daya OSS di bawah akun Anda, termasuk bucket, objek, dan bagian, dan atur jumlah maksimum hasil yang dikembalikan menjadi 20.
```
aliyun oss ls --limited-num 20
```

FAQ

Jika Anda mengalami kesalahan saat menggunakan ossutil, lihat topik berikut untuk memecahkan masalah kesalahan tersebut.

Perintah	Deskripsi
help	Mendapatkan informasi bantuan.
config	Membuat file konfigurasi untuk menyimpan item konfigurasi dan kredensial akses.
version	Menampilkan versi ossutil.
probe	Menjalankan tugas probe.