You need to enable JavaScript to run this app.
导航

通过授权码列举对象

最近更新时间2023.11.23 17:58:16

首次发布时间2023.01.12 20:36:47

您可以通过 share-ls 命令,使用授权码查询存储桶内对象,返回的对象列表将按照对象名以字典序排列。

命令格式

  • 基于直接输入的授权码,列举桶内对象或列举桶内多版本对象

    ./tosutil share-ls authorization_code [-key=xxx] [-s] [-d] [-v] [-marker=xxx] [-versionIdMarker==xxx] [-bf=xxx] [-limit=1] [-et=xxx] [-conf=xxx]
    
  • 基于授权码的文件路径,列举桶内对象或列举桶内多版本对象

    ./tosutil share-ls file://authorization_code_file_url [-key=xxx] [-s] [-d] [-v] [-marker=xxx] [-versionIdMarker==xxx] [-bf=xxx] [-limit=1] [-et=xxx] [-conf=xxx]
    

参数说明

通用可选参数的说明,请参通用可选参数

参数名

参数类型

描述

authorization_code

String

使用的授权码。

file://authorization_code_file_url

String

使用的授权码文件路径。

-key

String

列举单个对象时的对象名称,或者列举的对象前缀。

-s

Bool

以精简格式显示查询结果。

-d

Bool

仅列举当前目录下的对象和子目录,而非递归列举所有对象和子目录。

-v

Bool

列举桶内多版本对象,如果有历史版本对象,则列举结果包含最新版本的对象和历史版本的对象。

-marker

String

列举桶内多版本对象的起始位置,返回结果包括对象的最新版本和历史版本。

-versionIdMarker

String

列举桶内多版本对象的起始位置,必须与 -marker 配合使用。返回结果是对象名和版本号按照字典序排序后该参数以后的所有对象。

-bf

Enum

列举桶内对象时返回结果中字节数的显示格式。支持的值:

  • human-readable
  • raw

-limit

Integer

列举结果的最大个数,最大值为 100000。

-et

Enum

指定对返回的对象名进行编码的编码类型。当前仅支持 url

使用示例

  • 使用授权码路径和提取码,列举桶内所有对象
    以下命令用于列举 bucketname 桶内所有对象。使用的授权码路径为 /tmp/tosutil/authorization_code

    • 命令
    ./tosutil share-ls file:///tmp/tosutil/authorization_code 
    
    • 返回
    Start at 2022-12-26 11:38:01.418696 +0000 UTC
    
    Listing objects .
    
    Object list:
    key                                               LastModified                  Size      StorageClass        ETag                
    tos://bucketname/file/file1.png                   2022-10-27T09:38:41Z          55.98KB   STANDARD            "d411110de34d37ce8ca0ad0e4dd3****"
     
    tos://bucketname/file/file2.png                   2022-10-27T09:38:56Z          74.96KB   STANDARD            "0216c42adc88aadf0078dd6e4139****"
     
    tos://bucketname/file/file3.png                   2022-10-27T09:39:05Z          499B      STANDARD            "8a5f4cb1a4d760e32f9ee51482c3****"
     
    tos://bucketname/object1.png                      2022-10-27T09:37:08Z          55.98KB   STANDARD            "d411110de34d37ce8ca0ad0e4dd3****"
     
    tos://bucketname/object2.png                      2022-10-27T09:37:15Z          56.76KB   STANDARD            "0eaa38cb4273c20a8ec8a6345aeb****"
     
    tos://bucketname/object3.png                      2022-10-27T09:37:21Z          74.96KB   STANDARD            "0216c42adc88aadf0078dd6e4139****"
     
    Total size of bucket is: 319.14KB
    File number is: 6
    The authorized prefix is empty, all the content of bucket can be accessed
    
  • 使用授权码路径和提取码,列举桶内某个对象的所有版本
    以下命令用于列举 bucketname 桶内 object1.png 对象的所有版本。使用的授权码路径为 /tmp/tosutil/authorization_code

    • 命令
    ./tosutil share-ls file:///tmp/tosutil/authorization_code -key=object1.png -v -s
    
    • 返回
    Start at 2022-10-27 09:40:42.574241 +0000 UTC
     
    Listing versioning objects .
     
    Versioning Object list:
    tos://bucketname/object1.png
     
    Total size of prefix [object1.png] is: 55.98KB
    Versioning file number is: 1
    DeleteMarker number is: 0
    The authorized prefix is empty, all the content of bucket can be accessed
    
  • 使用授权码路径和提取码,列举桶内某个目录的所有对象
    以下命令用于列举 bucketname 桶内 file 文件夹内的对象。使用的授权码路径为 /tmp/tosutil/authorization_code

    • 命令
    ./tosutil share-ls file:///tmp/tosutil/authorization_code -key=file -s
    
    • 返回
    Start at 2022-10-27 09:42:54.896663 +0000 UTC
     
    Listing objects .
    
    Object list:
    tos://bucketname/file/file1.png
    tos://bucketname/file/file2.png
    tos://bucketname/file/file3.png
     
    Total size of prefix [file] is: 131.43KB
    File number is: 3
    The authorized prefix is empty, all the content of bucket can be accessed
    
  • 使用授权码和提取码,列举桶内某个目录的所有对象
    以下命令用于使用 file 文件夹的授权码,列举 bucketname 桶内 file 文件夹内的对象。使用的授权码为 xxx

    • 命令
    ./tosutil share-ls xxx -key=file/ -s
    
    • 返回
    Start at 2022-10-27 09:42:54.896663 +0000 UTC
     
    Listing objects .
    
    Object list:
    tos://bucketname/file/file1.png
    tos://bucketname/file/file2.png
    tos://bucketname/file/file3.png
     
    Total size of prefix [file/] is: 131.43KB
    File number is: 3
    The authorized prefix is [file/]