最近更新时间：2024.02.29 20:16:17
首次发布时间：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 | 列举桶内多版本对象的起始位置，必须与 |
-bf | Enum | 列举桶内对象时返回结果中字节数的显示格式。支持的值：
|
-limit | Integer | 列举结果的最大个数，最大值为 100000。 |
-et | Enum | 指定对返回的对象名进行编码的编码类型。当前仅支持 |
以下命令用于列举 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/]