Cara menggunakan ls untuk mendaftar sumber daya di tingkat akun - Object Storage Service

Untuk memeriksa dan mengelola sumber daya OSS dalam akun Anda, seperti memeriksa atau menghapus file besar, gunakan perintah ls untuk mendaftar bucket, objek, dan bagian dalam akun Anda saat ini.

Pertimbangan

Untuk mendaftar bucket, Anda memerlukan izin oss:ListBuckets.
Untuk mendaftar objek, Anda memerlukan izin oss:ListObjects.
Untuk mendaftar semua versi objek, Anda memerlukan izin oss:ListObjectVersions.
Untuk mendaftar semua bagian, Anda memerlukan izin oss:ListParts dan oss:ListMultipartUploads.

Untuk informasi lebih lanjut, lihat Berikan izin kustom kepada Pengguna RAM.

Sintaks perintah

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

Opsi lokal	Tipe	Deskripsi
--all-versions	/	Menentukan semua versi dari sebuah objek.
-d, --dirs	/	Mengembalikan objek dan subdirektori di direktori saat ini, bukan menampilkan secara rekursif semua objek di semua subdirektori.
--encoding-type	string	Metode pengkodean nama objek. Nilai valid: url.
--end-with	string	Memasangkan objek yang namanya secara leksikografis sebelum nilai opsi ini.
--exclude	stringArray	Aturan pengecualian untuk jalur atau nama objek.
--exclude-from	stringArray	Membaca aturan pengecualian dari sebuah file.
--files-from	stringArray	Membaca daftar nama objek sumber dari sebuah file, dengan baris kosong dan baris komentar diabaikan.
--files-from-raw	stringArray	Membaca daftar objek sumber dari sebuah file.
--filter	stringArray	Aturan filter untuk jalur atau nama objek.
--filter-from	stringArray	Membaca aturan filter dari sebuah file.
-f, --force	/	Memaksa operasi tanpa memerlukan konfirmasi pengguna.
--include	stringArray	Aturan inklusi untuk jalur atau nama objek.
--include-from	stringArray	Membaca aturan inklusi dari sebuah file.
--limited-num	int	Jumlah maksimum hasil yang akan dikembalikan.
--list-objects	/	Menentukan bahwa operasi ListObjects dipanggil untuk mendaftar objek.
--max-size	SizeSuffix	Ukuran maksimum objek yang dapat ditransfer. Secara default, ukuran dalam byte (B). Anda dapat menambahkan sufiks numerik berbasis 1024: B untuk byte, K untuk Kibibyte, M untuk Mebibyte, G untuk Gibibyte, T untuk Tebibyte, atau P untuk Pebibyte.
--metadata-exclude	stringArray	Aturan pengecualian untuk metadata objek.
--metadata-filter	stringArray	Aturan filter untuk metadata objek.
--metadata-filter-from	stringArray	Membaca aturan filter metadata dari sebuah file.
--metadata-include	stringArray	Aturan inklusi untuk metadata objek.
--min-age	Duration	Mendaftar hanya file yang dimodifikasi sebelum interval waktu tertentu. Unit default adalah detik. Anda juga dapat menggunakan sufiks unit. Contoh: 1h menunjukkan satu jam. Catatan `--min-age 1h` mendaftar hanya file yang dimodifikasi lebih dari 1 jam yang lalu.
--max-age	Duration	Mendaftar hanya file yang dimodifikasi dalam interval waktu tertentu. Unit default adalah detik. Anda juga dapat menggunakan sufiks unit. Contoh: 1h menunjukkan satu jam. Catatan `--max-age 1h` mendaftar hanya file yang dimodifikasi dalam satu jam terakhir.
--min-mtime	Time	Mendaftar hanya file yang dimodifikasi setelah waktu tertentu. Format waktu adalah UTC. Contoh: 2006-01-02T15:04:05. Catatan `--min-mtime "2006-01-02T15:04:05"` mendaftar hanya file yang dimodifikasi setelah 2 Januari 2006, 15:04:05.
--max-mtime	Time	Mendaftar hanya file yang dimodifikasi sebelum waktu tertentu. Format waktu adalah UTC. Contoh: 2006-01-02T15:04:05.
--min-size	SizeSuffix	Ukuran minimum objek yang dapat ditransfer. Secara default, ukuran dalam byte (B). Anda dapat menambahkan sufiks numerik berbasis 1024: B untuk byte, K untuk Kibibyte, M untuk Mebibyte, G untuk Gibibyte, T untuk Tebibyte, atau P untuk Pebibyte.
--multipart	/	Menerapkan operasi ke tugas multipart yang belum selesai dalam bucket.
--page-size	int	Jumlah maksimum objek yang dapat dikembalikan per halaman. Nilai default: 1000. Nilai valid: 1 hingga 1000.
-r, --recursive	/	Menentukan rekursi. Ketika opsi ini ditentukan, perintah melakukan operasi pada semua objek yang memenuhi kondisi dalam bucket. Jika tidak, perintah hanya melakukan operasi pada objek yang ditentukan oleh jalur.
--request-payer	string	Pembayar permintaan. Jika bayar-per-permintaan diaktifkan, tentukan parameter ini. Nilai valid: requester.
--short-format	/	Menampilkan item dalam format pendek. Jika Anda tidak menentukan opsi ini, format panjang digunakan.
--start-after	string	Memasangkan objek yang namanya secara leksikografis setelah nilai opsi ini.
--resource-group-id	string	Menentukan ID kelompok sumber daya.

Catatan

Untuk informasi lebih lanjut, lihat Opsi baris perintah.

Contoh

Daftarkan semua bucket dalam akun.
```
ossutil ls
```
Daftarkan semua objek dalam bucket examplebucket.
```
ossutil ls oss://examplebucket
```
Daftarkan semua objek dengan awalan nama "dir" dalam bucket examplebucket.
```
ossutil ls oss://examplebucket/dir
```
Daftarkan semua objek dengan awalan nama "dir" dalam direktori saat ini dari bucket examplebucket.
```
ossutil ls oss://examplebucket/dir -d
```
Daftarkan 100 objek pertama dengan awalan nama "dir" dalam bucket examplebucket.
```
ossutil ls oss://examplebucket/dir --limited-num 100
```
Daftarkan semua objek TXT dalam subdirektori dir1 dan dir2 dari Direktori root dalam bucket examplebucket.
```
ossutil ls oss://examplebucket/ --include "/dir1/**.txt" --include "/dir2/**.txt"
```
Daftarkan semua objek yang dibuat dalam tiga hari terakhir dalam subdirektori dir1 dan dir2 dari Direktori root dalam bucket examplebucket.
```
ossutil ls oss://examplebucket --include "/dir1/**" --include "/dir2/**" --max-age 3d
```
Daftarkan semua bucket dan keluarkan hasilnya dalam format JSON.
```
ossutil ls --output-format json
```