ls (List buckets, objects, or parts) - Object Storage Service

ls komutu, hesabınızdaki paketler, nesneler ve parçalar hakkında bilgi listeler. Bu komutu Object Storage Service (OSS) kaynaklarınızı sorgulamak ve yönetmek için kullanın; örneğin, depolama kullanımını yönetmek amacıyla büyük nesneleri bulmak ve silmek için bu komuttan yararlanabilirsiniz.

Kullanım notları

ossutil 1.6.16 sürümünden itibaren, işletim sisteminizden bağımsız olarak komutlarınızda ikili dosya adı olarak ossutil kullanabilirsiniz. 1.6.16'dan önceki sürümler için işletim sisteminize özel ikili dosya adını kullanmanız gerekir. Daha fazla bilgi için bkz. ossutil komut referansı.

İzinler

Alibaba Cloud hesapları varsayılan olarak tam izinlere sahiptir. Buna karşılık, RAM kullanıcılarının ve RAM rollerinin varsayılan izni yoktur. Hesap sahibi veya yönetici, bir RAM ilkesi veya paket ilkesi kullanarak onlara izin vermelidir.

API Eylemi	Açıklama
`oss:ListBuckets`	Bir hesaptaki paketleri listelemek için `ls` komutunu çalıştırmak üzere gereklidir.
`oss:ListObjects`	Belirtilen bir paketteki nesneleri listelemek için `ls` komutunu çalıştırmak üzere gereklidir.
`oss:ListObjectVersions`	İsteğe bağlı. `--all-versions` seçeneğini kullanırken bir nesnenin tüm sürümlerini listelemek için gereklidir.
`oss:ListMultipartUploads`	İsteğe bağlı. Tamamlanmamış veya iptal edilmiş çok parçalı yüklemeleri listelemek için gereklidir.
`oss:ListParts`	İsteğe bağlı. Parçaları listelemek için gereklidir.

Komut sözdizimi

ossutil ls cloud_url [options]

Parametreler

Parametre	Açıklama
cloud_url	İşlem yapılacak kaynağı belirtir. Biçim `oss://[bucket_name[/prefix]]` şeklindedir. Atlanırsa, mevcut hesaptaki erişim iznine sahip olduğunuz tüm paketler listelenir. `oss://bucket_name` belirtirseniz, paketteki tüm nesneler özyinelemeli olarak listelenir. `oss://bucket_name/prefix` belirtirseniz, pakette belirtilen ön ekle eşleşen tüm nesneler özyinelemeli olarak listelenir.
-s, --short-format	Çıktıyı basitleştirilmiş bir biçimde görüntüler. Sonuç yalnızca kaynak adlarını içerir.
-d, --directory	Özyinelemesiz listeleme yapar. Yalnızca geçerli yoldaki nesneleri ve ilk düzey alt dizinleri (`/` ile biten ortak ön ekler) listeler.
-m, --multipart	Belirtilen paketteki tamamlanmamış veya iptal edilmiş tüm çok parçalı yükleme görevlerini listeler. Not: Tamamlanmamış parçalar depolama alanı kaplar ve ücretlendirilir. Bunları düzenli olarak kontrol edin ve temizleyin.
-a, --all-type	Nesneler ve tamamlanmamış parçalar dahil olmak üzere tüm kaynak türlerini listeler.
--limited-num	Tek bir istekte döndürülecek maksimum sonuç sayısını belirtir. Bu seçeneği sayfalandırma için kullanabilirsiniz. Çok sayıda nesne listelenirken istek zaman aşımlarını önlemek için bu seçeneği sayfalandırma amacıyla `--marker` seçeneğiyle birlikte kullanın.
--marker	Listelemeye belirtilen işaretçiden başlar. Bir pakette çok sayıda nesne varsa, sayfalandırma için bu seçeneği `--limited-num` seçeneğiyle birlikte kullanın.
--upload-id-marker	Tamamlanmamış çok parçalı yüklemelerin listesini belirtilen UploadID'den devam ettirir.
--payer	Trafik ücretleri ve istek ücretleri gibi oluşan ücretlerin talep eden tarafından ödendiğini belirtir. Bu seçeneği `requester` olarak ayarlarsanız ücretler talep eden tarafından ödenir.
--include	Belirtilen joker karakter deseniyle eşleşen nesneleri listeler. Daha fazla bilgi için bkz. --include ve --exclude seçenekleri.
--exclude	Belirtilen joker karakter deseniyle eşleşen nesneleri listelemeden hariç tutar. Daha fazla bilgi için bkz. --include ve --exclude seçenekleri.
--all-versions	Bir nesnenin tüm geçmiş sürümlerini listeler. Bu seçenek yalnızca sürüm oluşturmanın etkinleştirildiği paketler için geçerlidir.
--version-id-marker	Bir nesnenin geçmiş sürümlerinin listesini belirtilen sürüm kimliğinden devam ettirir. Bu seçenek yalnızca sürüm oluşturmanın etkinleştirildiği paketler için geçerlidir.

Bu komutun diğer yaygın seçenekleri hakkında daha fazla bilgi için bkz. Ortak seçenekler.

Çıktı sonuçları

Döndürülen nesne listesindeki ETag değeri, nesne içeriğinin bütünlüğünü doğrulamak için kullanılır.

PutObject kullanılarak oluşturulan bir nesne için ETag değeri, içeriğin MD5 karmasıdır.
Çok parçalı yükleme gibi diğer yöntemlerle oluşturulan bir nesne için ETag değeri, içeriğin MD5 karması olmayan benzersiz bir değerdir.

Örnekler

Tüm paketleri listeleme

Hesabınızdaki erişilebilir tüm paketleri listelemek için herhangi bir parametre olmadan ls komutunu çalıştırın.

ossutil ls

Veya:

ossutil ls oss://

Örnek çıktı:

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

Paketleri basit modda listeleme

ossutil ls -s

Örnek çıktı:

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

Paketleri sayfalara bölerek listeleme

Çok sayıda paketiniz varsa, bunları sayfalara bölerek listelemek için --limited-num ve --marker seçeneklerini kullanın.

Adları alfabetik olarak examplebucketA işaretçisinden sonra gelen paketleri listeleyin.

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

Örnek çıktı:

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

Belirtilen bir paketteki tüm nesneleri listeleme

examplebucket paketindeki tüm nesneleri listeleyin.

ossutil ls oss://examplebucket

Örnek çıktı:

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

ETag değeri, bir nesnenin içeriğini tanımlamak için kullanılır. PutObject isteği kullanılarak oluşturulan bir nesne için ETag değeri, nesne içeriğinin MD5 karmasıdır. Diğer yöntemlerle oluşturulan bir nesne için ETag değeri, belirli kurallara göre oluşturulan ve nesne içeriğinin MD5 karması olmayan benzersiz bir değerdir.

Belirtilen bir dizinde (ön ekte) nesneleri listeleme

examplebucket paketinde example ön ekine sahip nesneleri listeleyin.

ossutil ls oss://examplebucket/example

Örnek çıktı:

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

Belirtilen bir uzantıya sahip nesneleri listeleme

examplebucket paketindeki tüm .mp4 dosyalarını listelemek için --include seçeneğini kullanın.

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

Örnek çıktı:

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

Nesneleri ve ilk düzey alt dizinleri özyinelemesiz listeleme

examplebucket paketinin kök dizinindeki yalnızca nesneleri ve ilk düzey alt dizinleri listelemek için -d seçeneğini kullanın. Alt dizinlerin içeriği özyinelemeli olarak listelenmez.

ossutil ls oss://examplebucket -d

Örnek çıktı:

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

Tüm nesnelerin tüm sürümlerini listeleme

Sürüm oluşturmanın etkinleştirildiği bir paket için tüm nesne sürümlerini listelemek üzere --all-versions seçeneğini kullanın.

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

Örnek çıktı:

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

Belirtilen bir nesnenin tüm sürümlerini listeleme

Sürüm oluşturmanın etkinleştirildiği bir paket için example.txt dosyasının tüm sürümlerini listelemek üzere --all-versions seçeneğini kullanın.

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

Örnek çıktı:

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

Tüm parçaları listeleme

Kesintiye uğramış veya başarısız olmuş yüklemelerden kaynaklanan examplebucket paketindeki tüm tamamlanmamış parçaları listelemek için -m seçeneğini kullanın. Bu parçalar depolama alanı tüketir ve ücretlendirilir. Gereksiz maliyetlerden kaçınmak için bu parçaları düzenli olarak silin.

ossutil ls oss://examplebucket -m

Örnek çıktı:

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

Tüm nesneleri ve parçaları listeleme

examplebucket paketindeki tüm nesneleri ve parçaları listelemek için -a seçeneğini kullanın.

ossutil ls oss://examplebucket -a

Örnek çıktı:

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

Başka bir hesap tarafından yetkilendirilen kaynakları listeleme

Singapur bölgesinde başka bir Alibaba Cloud hesabına ait olan bir test paketindeki tüm nesneleri listeleyin.

ossutil ls oss://test -e oss-ap-southeast-1.aliyuncs.com -i yourAccessKeyID  -k yourAccessKeySecret