Cara menggunakan ls untuk menampilkan daftar resource di tingkat akun - Object Storage Service

Perintah ls menampilkan informasi mengenai bucket, objek, dan bagian dalam akun Anda. Perintah ini dapat digunakan untuk melakukan kueri dan mengelola resource OSS, seperti menemukan serta menghapus file besar.

Prasyarat

Untuk menampilkan daftar bucket, Anda harus memiliki izin oss:ListBuckets.
Untuk menampilkan daftar objek, Anda harus memiliki izin oss:ListObjects.
Untuk menampilkan daftar semua versi objek, Anda harus memiliki izin oss:ListObjectVersions.
Untuk menampilkan daftar semua bagian, Anda harus memiliki izin oss:ListParts dan oss:ListMultipartUploads.

Untuk informasi selengkapnya, lihat Berikan kebijakan akses kustom kepada Pengguna RAM.

Format perintah

ossutil ls [oss://bucket[/prefix]] [flags]

Opsi	Tipe	Deskripsi
--all-versions	/	Menampilkan daftar semua versi objek.
-d, --dirs	/	Menampilkan daftar file dan subdirektori di direktori saat ini, bukan secara rekursif menampilkan semua file di semua subdirektori.
--encoding-type	string	Menentukan tipe encoding nama objek atau file. Nilainya dapat berupa `url`.
--end-with	string	Menampilkan daftar objek yang secara leksikografis berada sebelum nilai yang ditentukan.
--exclude	stringArray	Aturan pengecualian untuk path atau nama file.
--exclude-from	stringArray	Membaca aturan pengecualian dari file aturan.
--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 penyaringan untuk path atau nama file.
--filter-from	stringArray	Membaca aturan penyaringan dari file aturan.
-f, --force	/	Memaksa operasi tanpa prompt konfirmasi.
--include	stringArray	Aturan penyertaan untuk path atau nama file.
--include-from	stringArray	Membaca aturan penyertaan dari file aturan.
--limited-num	int	Jumlah maksimum hasil yang dikembalikan.
--list-objects	/	Menggunakan Operasi API ListObjects untuk menampilkan daftar objek.
--max-size	SizeSuffix	Menentukan ukuran maksimum file yang akan ditampilkan. Satuan default adalah byte. Anda juga dapat menggunakan akhiran seperti B, K, M, G, T, atau P. 1 K (KiB) = 1024 B.
--metadata-exclude	stringArray	Aturan pengecualian untuk metadata objek.
--metadata-filter	stringArray	Aturan penyaringan untuk metadata objek.
--metadata-filter-from	stringArray	Membaca aturan penyaringan metadata objek dari file aturan.
--metadata-include	stringArray	Aturan penyertaan untuk metadata objek.
--min-age	Duration	Hanya menampilkan file yang dimodifikasi sebelum interval waktu yang ditentukan. Satuan default adalah detik. Anda juga dapat menggunakan akhiran satuan. Misalnya, 1h berarti 1 jam. Catatan `--min-age 1h` hanya menampilkan file yang dimodifikasi lebih dari 1 jam lalu.
--max-age	Duration	Hanya menampilkan file yang dimodifikasi dalam interval waktu yang ditentukan. Satuan default adalah detik. Anda juga dapat menggunakan akhiran satuan. Misalnya, 1h berarti 1 jam. Catatan `--max-age 1h` hanya menampilkan file yang dimodifikasi dalam satu jam terakhir.
--min-mtime	Time	Hanya menampilkan 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:05Z"` hanya menampilkan file yang dimodifikasi setelah pukul 15:04:05 pada 2 Januari 2006.
--max-mtime	Time	Hanya menampilkan file yang dimodifikasi sebelum waktu yang ditentukan. Waktu harus dalam format UTC. Contohnya, 2006-01-02T15:04:05Z.
--min-size	SizeSuffix	Menentukan ukuran minimum file yang akan ditampilkan. Satuan default adalah byte. Anda juga dapat menggunakan akhiran seperti B, K, M, G, T, atau P. 1 K (KiB) = 1024 B.
--multipart	/	Menentukan bahwa operasi berlaku untuk event unggah multi-bagian yang belum lengkap di bucket.
--page-size	int	Jumlah maksimum objek yang ditampilkan per halaman untuk Pemrosesan batch. Nilai default: 1000. Nilai valid: 1 hingga 1000.
-r, --recursive	/	Menjalankan operasi secara rekursif. Jika Anda menentukan opsi ini, perintah dijalankan pada semua objek yang cocok di bucket. Jika tidak, perintah hanya dijalankan pada objek di path yang ditentukan.
--request-payer	string	Metode pembayaran untuk permintaan. Tetapkan ke `requester` jika Anda menggunakan mode bayar-per-permintaan.
--short-format	/	Menampilkan hasil dalam format singkat. Jika Anda tidak menentukan opsi ini, hasil ditampilkan dalam format panjang secara default.
--start-after	string	Menampilkan daftar objek yang secara leksikografis berada setelah nilai yang ditentukan.
--resource-group-id	string	Menentukan ID kelompok sumber daya.

Catatan

Untuk informasi selengkapnya, lihat Opsi baris perintah.

Contoh penggunaan

Tampilkan daftar semua bucket.
```
ossutil ls
```
Tampilkan daftar semua objek di bucket `examplebucket`.
```
ossutil ls oss://examplebucket
```
Tampilkan daftar semua objek dengan awalan `dir` di bucket `examplebucket`.
```
ossutil ls oss://examplebucket/dir
```
Tampilkan daftar semua objek yang berada langsung di dalam folder `dir` di bucket `examplebucket`.
```
ossutil ls oss://examplebucket/dir -d
```
Tampilkan daftar 100 objek pertama dengan awalan `dir` di bucket `examplebucket`.
```
ossutil ls oss://examplebucket/dir --limited-num 100
```
Tampilkan daftar semua file `.txt` di folder `dir1` dan `dir2` di bucket `examplebucket`.
```
ossutil ls oss://examplebucket/ --include "/dir1/**.txt" --include "/dir2/**.txt"
```
Tampilkan daftar semua file yang dibuat dalam tiga hari terakhir di folder `dir1` dan `dir2` di bucket `examplebucket`.
```
ossutil ls oss://examplebucket --include "/dir1/**" --include "/dir2/**" --max-age 3d
```
Tampilkan daftar semua bucket dan tampilkan output dalam format JSON.
```
ossutil ls --output-format json
```