Object Storage Service:Is

List buckets

• Command syntax

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

  The following table describes the options that you can configure in the command to list buckets.

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

• Examples

  • List all buckets that belong to the current Alibaba Cloud account.

    ./ossutil64 ls

    You can also run the following command to list all buckets owned by the current account:

    ./ossutil64 ls oss://

    The following output indicates that all buckets that belong to the current Alibaba Cloud account are listed. Listed information includes the bucket names, creation time, regions, storage classes, and number of the 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  

  • List all buckets in simple mode.

    ./ossutil64 ls -s

    The following output indicates that all buckets that belong to the current Alibaba Cloud account are listed. Listed information includes only the bucket names and the number of the buckets.

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

  • 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 options that you can configure in the command to list objects.

  Option	Description
  bucketname	Specifies the name of the bucket in which objects you want to list are stored.
  prefix	Specifies the prefix of objects that you want to list. Specifies the parameter when you want to list objects whose names contain the specified prefix.
  -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	Specifies the maximum number of objects to list. You can specify this parameter together with the marker parameter to display returned results by page.
  --marker	Specifies the position from which the list operation starts. Objects whose names are alphabetically after the value of marker are listed.
  --include	Specifies that objects that meet specified conditions are listed. For example, a value of *.jpg indicates that all objects in the JPG format are listed. For more information, see Batch upload objects that meet specified conditions.
  --exclude	Specifies that objects that do not meet specified conditions are listed. For example, a value of *.txt indicates that all objects that are not in the TXT format are listed.
  --version-id-marker	Specifies 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 when 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 when versioning is enabled for the bucket.

• Examples

  • 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. 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 using a PutObject request, 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                 

  • 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                 

  • 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                 

  • 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

  • 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

  • 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 options you can configure in the command to list parts.

  Option	Description
  bucketname	Specifies the name of the bucket in which parts you want to list are stored. Add this option when you want to list objects in a specified bucket.
  prefix	Specifies the parts whose names contain a specified prefix are listed.
  -s	Specifies that only upload IDs and objects 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	Specifies the maximum number of parts to list. You can specify this parameter together with the --upload-id-marker parameter to display returned results by page.
  --upload-id-marker	Specifies the position from which the list operation starts. Parts whose upload IDs are alphabetically greater than the value of marker are listed.

• Examples

  • 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  

  • 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.

./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 Is command, see Common options.