Is - Object Storage Service - Alibaba Cloud Documentation Center

You can run the ls command to list buckets, objects, and parts of the current Alibaba Cloud account.

Note

This topic provides sample command lines that are based on the 64-bit Linux system. For other systems, replace ./ossutil64 in the commands with the corresponding binary name. For more information, see ossutil.

List buckets

Command syntax

./ossutil64 ls [-s] [--limited-num] [--marker]

The following table describes the parameters that you can specify to list buckets of the current Alibaba Cloud account by running the Is command.

Parameter	Description
-s	Specifies that only bucket names are listed.
--limited-num	The maximum number of buckets that you want to list. You can specify this parameter together with the marker parameter to display the returned results by page.
--marker	The position from which the list operation starts. Buckets whose names are alphabetically after the value of marker are listed.

Examples

Run the following command to list all buckets of the current Alibaba Cloud account:

./ossutil64 ls

You can also run the following command to list all buckets of the current Alibaba Cloud account:

./ossutil64 ls oss://

The following output indicates that all buckets of the current Alibaba Cloud account are listed. The listed information includes the bucket names, creation time, regions, storage classes, and number of buckets.

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

Run the following command to list all buckets of the current Alibaba Cloud account in simple mode:
```
./ossutil64 ls -s
```
The following output indicates that all buckets of the current Alibaba Cloud account are listed. The listed information includes only the bucket names and number of buckets.
```
oss://examplebucketA
oss://examplebucketB
oss://examplebucketC
oss://examplebucketD
Bucket Number is:4
0.235104(s) elapsed  
```

Run the following command to list buckets whose names are alphabetically after examplebucketA, which is specified by the marker parameter:

./ossutil64 ls oss:// --limited-num=2 -s --marker examplebucketA

The following output indicates that two buckets whose names are alphabetically after examplebucketA are listed.

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

List objects

Command syntax

./ossutil64 ls oss://bucketname[/prefix] [-s] [-d] [--limited-num] [--marker] [--include] [--exclude]  [--version-id-marker] [--all-versions]

The following table describes the parameters that you can specify to list objects of the current Alibaba Cloud account by running the Is command.

Parameter	Description
bucketname	The name of the bucket in which the objects that you want to list are stored.
prefix	The prefix that is contained in the names of the objects that you want to list.
-s	Specifies that only object names are listed.
-d	Specifies that only objects and subdirectories in the root directory of the bucket are listed. Objects in subdirectories are not listed.
--limited-num	The maximum number of objects that you want to list. You can specify this parameter together with the marker parameter to display the returned results by page.
--marker	The position from which the list operation starts. Objects whose names are alphabetically after the value of marker are listed.
--include	Objects that meet the specified conditions are listed. For more information, see Is.
--exclude	Objects that do not meet the specified conditions are listed. For more information, see Is.
--version-id-marker	The position from which the list operation starts. Object versions whose IDs are alphabetically after the value of marker are listed. You can specify this parameter only after versioning is enabled for the bucket.
--all-versions	Specifies that all versions of objects in the bucket are listed. You can specify this parameter only after versioning is enabled for the bucket.

Examples

Run the following command to list all objects in a bucket named examplebucket:
```
./ossutil64 ls oss://examplebucket
```
The following output indicates that all objects in the examplebucket bucket are listed. The listed information includes the last modified time, sizes, ETag values, and names of the objects.
The ETag value of an object is used to identify the content of the object. If an object is created by calling the PutObject operation, the ETag of the object is the MD5 hash of the object content. If an object is created by using other methods, the ETag of the object is not the MD5 hash of the object content but a unique value calculated based on the object.
```
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                 
```

Run the following command to list objects whose names contain the example prefix in a bucket named examplebucket:

./ossutil64 ls oss://examplebucket/example

The following output indicates that all objects whose names contain the example prefix in the examplebucket bucket are listed.

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

Run the following command to list objects whose names contain the .mp4 suffix in a bucket named examplebucket:

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

The following output indicates that objects whose names contain the .mp4 suffix in the examplebucket bucket are listed.

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

Run the following command to list only objects and subdirectories in the root directory of a bucket named examplebucket:
```
./ossutil64 ls oss://examplebucket -d
```
The following output indicates that objects and subdirectories in the root directory of the examplebucket bucket are listed.
```
oss://examplebucket/example.txt
oss://examplebucket/examplefolder/
oss://examplebucket/video.mp4
Object and Directory Number is: 3

0.278489(s) elapsed
```

Run the following command to list all versions of all objects in a bucket named examplebucket.

./ossutil64 ls oss://examplebucket --all-versions

The following output indicates that all versions of all objects in the examplebucket bucket are listed.

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

Run the following command to list all versions of an object named example.txt in the root directory of a bucket named examplebucket:

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

The following output indicates that all versions of the example.txt object are listed.

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.361000(s) elapsed

List parts

Command syntax

./ossutil64 ls oss://bucketname[/prefix] [-s] [-d] [-m] [-a] [--limited-num] [--upload-id-marker]

The following table describes the parameters that you can specify to list parts of the current Alibaba Cloud account by running the Is command.

Parameter	Description
bucketname	The name of the bucket in which the objects that you want to list are stored. If you want to list objects in a bucket, specify this parameter.
prefix	Specifies that the parts whose names contain a specific prefix are listed.
-s	Specifies that only upload IDs and object names are listed.
-d	Specifies that only objects and subdirectories in the root directory of the bucket are listed. Objects in subdirectories are not listed.
-m	Specifies that the command is run to list parts.
-a	Specifies that the command is run to list objects and parts.
--limited-num	The maximum number of parts that you want to list. You can specify this parameter together with the --upload-id-marker parameter to display returned results by page.
--upload-id-marker	The position from which the list operation starts. Parts whose upload IDs are alphabetically after the value of marker are listed.

Examples

Run the following command to list all parts in a bucket named examplebucket:

./ossutil64 ls oss://examplebucket -m

The following output indicates that all parts in the examplebucket bucket are listed.

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.191289(s) elapsed

Run the following command to list all objects and parts in a bucket named examplebucket:

./ossutil64 ls oss://examplebucket -a

The following output indicates that all objects and parts in the examplebucket bucket are listed.

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

Common options

If you use ossutil to switch to a bucket that is located in another region, add the -e option to the command to specify the endpoint of the region in which the specified bucket is located. If you use ossutil to switch to a bucket that belongs to another Alibaba Cloud account, you can add the -i option to the command to specify the AccessKey ID of the specified account, and add the -k option to the command to specify the AccessKey secret of the specified account.

For example, you can run the following command to list all objects in a bucket named test that is located in the China (Hangzhou) region and owned by another Alibaba Cloud account:

./ossutil64 ls oss://test -e oss-cn-hangzhou.aliyuncs.com -i LTAI4Fw2NbDUCV8zYUzA****  -k 67DLVBkH7EamOjy2W5RVAHUY9H****

For more information about other common options that you can use for the sync command, see View options.