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

列举账号下资源

最近更新时间2023.11.23 17:58: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