You need to enable JavaScript to run this app.
导航
对象存储
  • 文档首页
    • /
  • 对象存储

列举账号下资源（ls）

最近更新时间：2024.02.29 20:16:15

首次发布时间：2022.11.03 10:30:29

我的收藏

您可以使用 ls 命令列举账号下的资源信息，包括桶、桶内对象及桶内分片上传任务。

列举桶

命令格式

./tosutil ls [-s] [-limit=1] [-e=xxx] [-re=xxx] [-i=xxx] [-k=xxx] [-t=xxx] [-conf=xxx]

参数说明

通用可选参数的说明，请参见通用可选参数。

参数名

参数类型

描述

-s

Bool

以精简格式显示查询结果，只返回存储桶名称。

-limit

Integer

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

使用示例

列举所有桶

  • 命令

    ./tosutil ls

  • 返回

    Start at 2022-10-27 09:29:45.79638 +0000 UTC
Bucket                   CreationDate                  Location       
tos://db-storage         2022-07-28T06:53:37Z          cn-beijing     
 
tos://tosutil            2022-07-05T09:40:35Z          cn-beijing     

Bucket number is: 2

以精简格式列举所有桶

  • 命令

    ./tosutil ls -s

  • 返回

    Start at 2022-10-27 09:29:45.79638 +0000 UTC
tos://db-storage
tos://tosutil
Bucket number is: 2

列举桶内对象或列举桶内多版本对象

命令格式

./tosutil ls tos://bucket[/prefix] [-s] [-d] [-v] [-marker=xxx] [-versionIdMarker=xxx] [-bf=xxx] [-limit=1] [-et=xxx] [-e=xxx] [-re=xxx] [-i=xxx] [-k=xxx] [-t=xxx] [-conf=xxx]

参数说明

通用可选参数的说明，请参见通用可选参数。

参数名

参数类型

描述

bucket

String

列举时指定的桶名。

prefix

String

列举时指定的对象名前缀。

-s

Bool

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

-d

Bool

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

-v

Bool

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

-marker

String

列举桶内对象的起始位置，返回结果为对象名称按照字典序排序后，该参数以后的所有对象。

-versionIdMarker

String

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

-bf

Enum

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

  • human-readable
  • raw

-limit

Integer

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

-et

Enum

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

使用示例

列举桶内所有对象

以下命令用于列举 bucketname 桶内所有对象。

  • 命令

    ./tosutil ls tos://bucketname

  • 返回

    Start at 2022-10-27 09:39:39.710781 +0000 UTC
 
Listing objects .
 
Folder list:
tos://bucketname/file/
 
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
Folder number is: 1
File number is: 6

列举指定对象的所有版本

以下命令用于列举 bucketname 桶内 object1.png 对象的所有版本。

  • 命令

    ./tosutil ls -s tos://bucketname/object1.png -v

  • 返回

    Start at 2022-10-27 09:40:42.574241 +0000 UTC
 
Listing versioning objects .
 
Folder list:
tos://bucketname/file/
 
Versioning Object list:
tos://bucketname/file/file1.png
tos://bucketname/file/file2.png
tos://bucketname/file/file3.png
tos://bucketname/object1.png
tos://bucketname/object2.png
tos://bucketname/object3.png
tos://bucketname/screenshot-20220521-154619.png
tos://bucketname/screenshot-20220521-154719.png
tos://bucketname/screenshot-20220608-152001.png
 
DeleteMarker list:
tos://bucketname/screenshot-20220521-154619.png
tos://bucketname/screenshot-20220521-154719.png
tos://bucketname/screenshot-20220608-152001.png
 
Total size of prefix [object1.png] is: 506.84KB
Folder number is: 1
Versioning file number is: 9
DeleteMarker number is: 3

列举文件夹内的对象

以下命令用于列举 bucketname 桶内 file 文件夹内的对象。

  • 命令

    ./tosutil ls -s tos://bucketname/file

  • 返回

    Start at 2022-10-27 09:42:54.896663 +0000 UTC
 
Listing objects .
 
Folder list:
tos://bucketname/file/
 
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
Folder number is: 1
File number is: 3

列举桶内分片上传任务

命令格式

./tosutil ls tos://bucket[/prefix] [-s] [-d] -m [-uploadIdMarker=xxx] [-marker=xxx] [-limit=1] [-et=xxx] [-e=xxx] [-re=xxx] [-i=xxx] [-k=xxx] [-t=xxx] [-conf=xxx]

参数说明

通用可选参数的说明，请参见通用可选参数。

参数名

参数类型

描述

bucket

String

列举时指定的桶名。

prefix

String

列举时指定的对象名前缀。

-s

Bool

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

-d

Bool

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

-uploadIdMarker

String

列举桶内分片上传任务的起始位置，必须与 -marker 配合使用。
返回结果是对象名和UploadId 按照字典序排序后该参数以后的所有分片上传任务。

-limit

Integer

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

-et

Enum

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

-m

Bool

代表列举桶内分片上传任务。

使用示例

以下命令用于查询 bucketname 桶的分片上传任务。

  • 命令
./tosutil ls tos://bucketname -m
  • 返回
Start at 2022-10-27 10:01:16.253119 +0000 UTC
 
Listing multipart uploads .
 
Upload list:
Key                                               Initiated                     StorageClass        UploadId            
tos://bucketname/Visual Studio Code.app/Contents/Frameworks/Electron Framework.framework/Versions/A/Electron Framework
                                                  2022-10-27T10:00:11Z          STANDARD            6b229265e5bcef1437b2485a56ab****
 
tos://bucketname/安装包/Postman-osx-8.12.4-x64.zip
                                                  2022-10-27T10:01:08Z          STANDARD            6b22926509948cb9e10f485a56e4****
 
tos://bucketname/安装包/VSCode-darwin-universal (1).zip
                                                  2022-10-27T10:01:08Z          STANDARD            6b229265c48609aa37b2485a56e4****
 
tos://bucketname/安装包/draw.io-universal-16.5.1.dmg
                                                  2022-10-27T10:01:08Z          STANDARD            6b2292654a1ce26510f94a5a56e4****
 
tos://bucketname/安装包/go1.17.5.darwin-amd64 (1).pkg
                                                  2022-10-27T10:01:08Z          STANDARD            6b2292656a550d73e10f485a56e4****
 
tos://bucketname/安装包/node-v14.18.1.pkg
                                                  2022-10-27T10:01:09Z          STANDARD            6b229265ddf1d388e10f485a56e5****
 
tos://bucketname/安装包/未确认 442045.crdownload
                                                  2022-10-27T10:01:09Z          STANDARD            6b229265b3475a44e10f485a56e5****
 
tos://bucketname/安装包/未确认 610983.crdownload
                                                  2022-10-27T10:01:12Z          STANDARD            6b2292655bccfae610f94a5a56e8****
 
Folder number is: 0
Upload number is: 8