您可以使用 ls
命令列举账号下的资源信息,包括桶、桶内对象及桶内分片上传任务。
./tosutil ls [-s] [-limit=1] [-e=xxx] [-re=xxx] [-i=xxx] [-k=xxx] [-t=xxx] [-conf=xxx]
通用可选参数的说明,请参见通用可选参数。
参数名 | 参数类型 | 描述 |
---|---|---|
-s | Bool | 以精简格式显示查询结果,只返回存储桶名称。 |
-limit | Integer | 列举结果的最大个数。 |
命令
./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 | 列举桶内多版本对象的起始位置,必须与 |
-bf | Enum | 列举桶内对象时返回结果中字节数的显示格式。支持的值:
|
-limit | Integer | 列举结果的最大个数。 |
-et | Enum | 指定对返回的对象名进行编码的编码类型。当前仅支持 |
以下命令用于列举 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 | 列举桶内分片上传任务的起始位置,必须与 |
-limit | Integer | 列举结果的最大个数。 |
-et | Enum | 指定对返回的对象名进行编码的编码类型。当前仅支持 |
-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