ls (Daftar bucket, objek, atau bagian) - Object Storage Service

Untuk mengkueri dan mengelola sumber daya Object Storage Service (OSS) di akun Anda—misalnya, menemukan dan menghapus file besar—Anda dapat menggunakan perintah ls untuk mendaftar bucket, objek, dan bagian.

Catatan penggunaan

Mulai versi ossutil 1.6.16 dan yang lebih baru, Anda dapat menggunakan ossutil sebagai nama biner dalam perintah tanpa perlu menyesuaikannya dengan sistem operasi. Jika menggunakan versi sebelum 1.6.16, Anda harus memperbarui nama biner sesuai sistem operasi Anda. Untuk informasi selengkapnya, lihat Referensi perintah ossutil.

Deskripsi izin

Secara default, Akun Alibaba Cloud memiliki semua izin. Pengguna RAM atau Peran RAM yang termasuk dalam Akun Alibaba Cloud tidak memiliki izin secara default. Akun Alibaba Cloud atau administrator harus memberikan izin melalui Kebijakan RAM atau kebijakan bucket.

Tindakan API	Deskripsi
`oss:ListBuckets`	Izin yang diperlukan untuk menjalankan perintah `ls` guna mendaftar bucket dalam suatu akun.
`oss:ListObjects`	Izin yang diperlukan untuk menjalankan perintah `ls` guna mendaftar objek dalam bucket tertentu.
`oss:ListObjectVersions`	Opsional. Izin yang diperlukan untuk mendaftar semua versi objek ketika opsi `--all-versions` ditentukan.
`oss:ListMultipartUploads`	Opsional. Izin yang diperlukan untuk mendaftar tugas unggah multi-bagian yang belum lengkap atau dibatalkan.
`oss:ListParts`	Opsional. Izin yang diperlukan untuk mendaftar bagian.

Sintaks perintah

ossutil ls cloud_url [opsi]

Deskripsi parameter

Parameter	Deskripsi
cloud_url	Menentukan sumber daya yang akan dioperasikan. Formatnya adalah `oss://[bucket_name[/prefix]]`. Jika dihilangkan, semua bucket yang Anda miliki izin aksesnya dalam akun saat ini akan didaftar. Jika Anda menentukan `oss://bucket_name`, semua objek dalam bucket tersebut akan didaftar secara rekursif. Jika Anda menentukan `oss://bucket_name/prefix`, semua objek dalam bucket yang cocok dengan awalan yang ditentukan akan didaftar secara rekursif.
-s, --short-format	Menampilkan keluaran dalam format yang disederhanakan. Hasil hanya mencakup nama sumber daya.
-d, --directory	Menjalankan pendaftaran non-rekursif. Hanya mendaftar objek dan subdirektori tingkat pertama (awalan umum yang diakhiri dengan `/`) pada path saat ini.
-m, --multipart	Mendaftar semua tugas unggah multi-bagian yang belum lengkap atau dibatalkan dalam bucket yang ditentukan. Catatan Bagian yang belum lengkap menempati ruang penyimpanan dan dikenai biaya. Periksa dan hapus secara berkala.
-a, --all-type	Mendaftar semua jenis sumber daya, termasuk objek dan bagian yang belum lengkap.
--limited-num	Menetapkan jumlah maksimum hasil yang dikembalikan untuk satu permintaan. Opsi ini dapat digunakan untuk paginasi. Jika sebuah bucket berisi banyak objek, gunakan opsi ini bersama opsi `--marker` untuk paginasi guna mencegah timeout permintaan yang disebabkan oleh pendaftaran terlalu banyak objek sekaligus.
--marker	Memulai pendaftaran dari marker yang ditentukan. Jika sebuah bucket berisi banyak objek, gunakan opsi ini bersama opsi `--limited-num` untuk paginasi.
--upload-id-marker	Melanjutkan pendaftaran tugas unggah multi-bagian yang belum lengkap setelah UploadID yang ditentukan.
--payer	Menentukan bahwa pemohon membayar akses tersebut. Jika Anda mengatur opsi ini ke `requester`, pemohon membayar biaya yang timbul, seperti biaya lalu lintas dan biaya permintaan.
--include	Mendaftar objek yang cocok dengan format karakter wildcard yang ditentukan. Untuk informasi selengkapnya, lihat opsi --include dan --exclude.
--exclude	Mendaftar objek yang tidak cocok dengan format karakter wildcard yang ditentukan. Untuk informasi selengkapnya, lihat opsi --include dan --exclude.
--all-versions	Mendaftar semua versi historis suatu objek. Opsi ini hanya berlaku untuk bucket yang telah diaktifkan fitur Pengendalian versi.
--version-id-marker	Melanjutkan pendaftaran versi historis suatu objek setelah ID versi yang ditentukan. Opsi ini hanya berlaku untuk bucket yang telah diaktifkan fitur Pengendalian versi.

Untuk informasi selengkapnya tentang opsi umum lainnya untuk perintah ini, lihat Opsi umum.

Hasil keluaran

Nilai ETag dalam daftar objek yang dikembalikan digunakan untuk memverifikasi integritas konten objek.

Untuk objek yang dibuat menggunakan permintaan PutObject, nilai ETag-nya adalah hash MD5 dari konten objek tersebut.
Untuk objek yang dibuat menggunakan metode seperti unggah multi-bagian, nilai ETag-nya adalah pengidentifikasi unik tetapi bukan hash MD5 dari konten objek tersebut.

Contoh penggunaan

Daftar semua bucket

Jalankan perintah ls tanpa parameter apa pun untuk mendaftar semua bucket yang Anda miliki izin aksesnya dalam akun Anda.

ossutil ls

atau

ossutil ls oss://

Keluaran:

2016-10-21 16:18:37 +0800 CST       oss-cn-hangzhou         Archive    oss://examplebucketA
2016-12-01 15:06:21 +0800 CST       oss-cn-hangzhou        Standard    oss://examplebucketB
2016-07-20 10:36:24 +0800 CST       oss-cn-hangzhou              IA    oss://examplebucketC
2016-10-21 17:31:27 +0800 CST       oss-cn-hangzhou         Archive    oss://examplebucketD
Bucket Number is:4
0.252174(s) elapsed

Daftar bucket dalam mode sederhana

ossutil ls -s

Contoh keluaran:

oss://examplebucketA
oss://examplebucketB
oss://examplebucketC
oss://examplebucketD
Bucket Number is:4
0.235104(s) elapsed

Daftar bucket per halaman

Jika Anda memiliki banyak bucket, Anda dapat menggunakan opsi --limited-num dan --marker untuk mendaftarkannya per halaman.

Daftar bucket yang namanya secara alfabetis berada setelah marker examplebucketA.

ossutil ls  --limited-num=2 -s --marker examplebucketA

Contoh keluaran:

2016-12-01 15:06:21 +0800 CST       oss-cn-hangzhou        Standard    oss://examplebucketB
2016-07-20 10:36:24 +0800 CST       oss-cn-hangzhou              IA    oss://examplebucketC
Bucket Number is:2
0.132174(s) elapsed

Daftar semua objek dalam bucket tertentu

Daftar semua objek dalam bucket examplebucket.

ossutil ls oss://examplebucket

Contoh keluaran:

LastModifiedTime                    Size(B)  StorageClass   ETag                                    ObjectName
2020-12-01 15:06:37 +0800 CST           114      Standard   61DE142E5AFF9A6748707D4A77BFBCFB        oss://examplebucket/example.txt
2020-12-01 15:06:42 +0800 CST        363812      Standard   E7581E5D2EBC56ECCB6FB6050B4C6545        oss://examplebucket/examplefolder/photo.jpg
2020-12-01 15:06:45 +0800 CST      57374182      Standard   BE97B7AD7A2C1277B11221E5C9537544        oss://examplebucket/video.mp4
Object Number is:3
0.007379(s) elapsed

Nilai ETag digunakan untuk mengidentifikasi konten objek. Untuk objek yang dibuat menggunakan permintaan PutObject, nilai ETag adalah hash MD5 dari konten objek tersebut. Untuk objek yang dibuat menggunakan metode lain, nilai ETag adalah nilai unik yang dihasilkan berdasarkan aturan tertentu dan bukan hash MD5 dari konten objek tersebut.

Daftar objek dalam direktori (awalan) tertentu

Daftar objek yang memiliki awalan example dalam bucket examplebucket.

ossutil ls oss://examplebucket/example

Contoh keluaran:

LastModifiedTime                    Size(B)  StorageClass   ETag                                     ObjectName
2020-12-01 15:06:37 +0800 CST           114      Standard   61DE142E5AFF9A6748707D4A77BFBCFB        oss://examplebucket/example.txt
2020-12-01 15:06:42 +0800 CST        363812      Standard   E7581E5D2EBC56ECCB6FB6050B4C6545        oss://examplebucket/examplefolder/photo.jpg
Object Number is:2
0.007379(s) elapsed

Daftar objek dengan akhiran tertentu

Anda dapat menggunakan opsi --include untuk mendaftar semua file .mp4 dalam bucket examplebucket.

ossutil ls oss://examplebucket --include *.mp4

Contoh keluaran:

LastModifiedTime                    Size(B)  StorageClass   ETag                                     ObjectName
2020-12-01 15:06:45 +0800 CST      57374182      Standard   BE97B7AD7A2C1277B11221E5C9537544        oss://examplebucket/video.mp4
Object Number is:1
0.007379(s) elapsed

Daftar non-rekursif objek dan subdirektori tingkat pertama

Gunakan opsi -d untuk hanya mendaftar objek dan subdirektori tingkat pertama dalam direktori root bucket examplebucket. Konten subdirektori tidak didaftar secara rekursif.

ossutil ls oss://examplebucket -d

Keluaran:

oss://examplebucket/example.txt
oss://examplebucket/examplefolder/
oss://examplebucket/video.mp4
Object and Directory Number is: 3
0.278(s) elapsed

Daftar semua versi semua objek

Untuk bucket yang telah diaktifkan fitur Pengendalian versi, gunakan opsi --all-versions untuk mendaftar semua versi objek.

ossutil ls oss://examplebucket --all-versions

Keluaran:

LastModifiedTime                   Size(B)  StorageClass   ETag                                   VERSIONID                                                           IS-LATEST   DELETE-MARKER   ObjectName
2020-12-01 15:06:37 +0800 CST         114      Standard   61DE142E5AFF9A6748707D4A77BFBCFB      CAEQARiBgICUsOuR2hYiIDI3NWVjNmEyYmM0NTRkZWNiMTkxY2VjMDMwZjFlMDA3    true        false           oss://examplebucket/example.txt
2020-06-11 11:03:37 +0800 CST      363812      Standard   E7581E5D2EBC56ECCB6FB6050B4C6545      CAEQARiBgIDZtvuR2hYiIDNhYjRkN2M5NTA5OTRlN2Q4YTYzODQwMzQ4NDYwZDdm    true        false           oss://examplebucket/examplefolder/photo.jpg
2021-01-26 13:27:08 +0800 CST           0                                                       CAEQLxiBgIDd7NH0uRciIDA3Yzg0MTZjOWNlYzQ4ODZhMzVkZWE0MmE2NzBlYTYx    true        true            oss://examplebucket/image.png
2020-12-01 15:06:45 +0800 CST    57374182      Standard   BE97B7AD7A2C1277B11221E5C9537544      CAEQLBiBgMDZiprwthciIDY2NGM0NTNmZDE3ODRmZmVhZGM4YTUwZGQyNGU3ZjQ3    true        false           oss://examplebucket/video.mp4
2016-06-11 10:53:46 +0800 CST      118076      Standard   FFDB300F053AAF06F4C4C58A4869C427      CAEQARiBgID8rumR2hYiIGUyOTAyZGY2MzU5MjQ5ZjlhYzQzZjNlYTAyZDE3MDRk    false       false           oss://examplebucket/example.txt
2016-06-11 11:02:05 +0800 CST      345374      Standard   078A9852BCF81DC4811E6EDCBFD121BE      CAEQARiBgICNz_iR2hYiIGJjZTBjNDQxYWRhNTQ2ZTNiNmMzYzQ1YzMzMDA5ZjUw    false       false           oss://examplebucket/examplefolder/photo.jpg
Object Number is: 6

0.692000(s) elapsed

Daftar semua versi objek tertentu

Untuk bucket yang telah diaktifkan fitur Pengendalian versi, gunakan opsi --all-versions untuk mendaftar semua versi example.txt.

ossutil ls oss://examplebucket/example.txt --all-versions

Contoh keluaran:

LastModifiedTime                   Size(B)  StorageClass  ETag                                   VERSIONID                                                           IS-LATEST   DELETE-MARKER  ObjectName
2020-12-01 15:06:37 +0800 CST         114      Standard   61DE142E5AFF9A6748707D4A77BFBCFB      CAEQARiBgICUsOuR2hYiIDI3NWVjNmEyYmM0NTRkZWNiMTkxY2VjMDMwZjFlMDA3    true        false           oss://examplebucket/example.txt
2016-06-11 10:53:46 +0800 CST         114      Standard   61DE142E5AFF9A6748707D4A77BFBCFB      CAEQARiBgID8rumR2hYiIGUyOTAyZGY2MzU5MjQ5ZjlhYzQzZjNlYTAyZDE3MDRk    false       false           oss://examplebucket/example.txt
Object Number is: 2
0.361(s) elapsed

Daftar semua bagian

Gunakan opsi -m untuk mendaftar semua bagian yang belum lengkap dalam examplebucket yang dihasilkan dari unggahan yang terganggu atau gagal. Bagian-bagian ini mengonsumsi ruang penyimpanan dan dikenai biaya. Hapus bagian-bagian ini secara berkala untuk menghindari biaya yang tidak perlu.

ossutil ls oss://examplebucket -m

Contoh keluaran:

InitiatedTime                     UploadID                           ObjectName
2017-01-13 03:45:26 +0000 CST     15754AF7980C4DFB8193F190837520BB    oss://examplebucket/test.mp4
2017-01-20 11:16:21 +0800 CST     A20157A7B2FEC4670626DAE0F4C0073C    oss://examplebucket/object.exe
UploadId Number is: 2
0.191(s) elapsed

Daftar semua objek dan bagian

Anda dapat menggunakan opsi -m untuk mendaftar semua objek dan bagian dalam examplebucket.

ossutil ls oss://examplebucket -a

Contoh keluaran:

LastModifiedTime                    Size(B)  StorageClass   ETag                                     ObjectName
2020-12-01 15:06:37 +0800 CST           114      Standard   61DE142E5AFF9A6748707D4A77BFBCFB        oss://examplebucket/example.txt
2020-12-01 15:06:42 +0800 CST        363812      Standard   E7581E5D2EBC56ECCB6FB6050B4C6545        oss://examplebucket/examplefolder/photo.jpg
2020-12-01 15:06:45 +0800 CST      57374182      Standard   BE97B7AD7A2C1277B11221E5C9537544        oss://examplebucket/video.mp4
Object Number is:3
InitiatedTime                     UploadID                           ObjectName
2017-01-13 03:45:26 +0000 CST     15754AF7980C4DFB8193F190837520BB    oss://examplebucket/test.mp4
2017-01-13 03:45:13 +0000 CST     2A1F9B4A95E341BD9285CC42BB950EE0    oss://examplebucket/test.mp4
2017-01-13 03:45:01 +0000 CST     3998971ACAF94AD9AC48EAC1988BE863    oss://examplebucket/test.mp4
2017-01-20 11:16:21 +0800 CST     A20157A7B2FEC4670626DAE0F4C0073C    oss://examplebucket/object.exe
UploadId Number is:4
0.791289(s) elapsed

Daftar sumber daya yang diotorisasi oleh akun lain

Anda dapat mendaftar semua file dalam bucket test yang dimiliki oleh Akun Alibaba Cloud lain di wilayah Tiongkok (Hangzhou).

ossutil ls oss://test -e oss-cn-hangzhou.aliyuncs.com -i yourAccessKeyID  -k yourAccessKeySecret