列举对象
使用ls命令查询EIHealth项目中的对象，返回的对象名称按照字典序排列。同时，该命令支持显示引用的其他项目的数据。
在使用该命令前，需要使用switch命令进入待操作的项目，才可以执行数据相关操作，使用逻辑与EIHealth平台相同。
命令结构
health ls <path> [flags]
参数 |
简写 |
是否必选 |
描述 |
|---|---|---|---|
path |
无 |
否 |
路径名称。
|
--limit |
-l |
否 |
列举查询结果的最大个数，小于等于0表示列举所有结果，不设置时默认为最大值1000。 引用数据会列举全部，不受该参数影响 。 |
--simple |
-s |
否 |
以精简格式显示查询结果，返回结果只包含对象名。 |
--recursive |
-r |
否 |
递归列举本项目文件夹中的所有文件和子文件夹。 |
--v |
-v |
否 |
列举桶内多版本对象，列举结果包含最新版本的对象和历史版本的对象。 |
--marker |
-M |
否 |
列举桶内对象的起始位置，返回结果是按照字典序排序后该参数之后的所有对象，具体可参考列举示例。 |
--versionIdMarker |
-V |
否 |
列举桶内多版本对象的起始位置，返回结果是对象名和版本号按照字典序排序后该参数之后的所有对象。 必须与--v和--marker配合使用。 如果--versionIdMarker的版本号不包含在--marker返回结果对应的版本号中，则该参数无效。 |
--bf |
-b |
否 |
列举结果中字节数的显示格式。取值范围[human-readable, raw]。 如果未设置该参数，则列举结果中字节数的显示格式由配置文件中的humanReadableFormat参数决定。 |
--format |
-F |
否 |
指定以自定义格式打印列举结果。当前仅支持值[default]，指定列举结果在一行显示。 |
--a |
-a |
否 |
同时列举桶内对象和桶内分段上传任务。 |
--m |
-m |
否 |
列举桶内分段上传任务。 |
--e |
-P |
否 |
指定终端节点。 |
--i |
-i |
否 |
指定用户的AK。 |
--k |
-k |
否 |
指定用户的SK。 |
--t |
-n |
否 |
指定用户的securitytoken。 |
--uploadIdMarker |
-u |
否 |
列举桶内分段上传任务的起始位置，必须与--marker配合使用。返回结果是对象名和UploadId按照字典序排序后该参数之后的所有分段上传任务。 |
命令示例
本节以Windows为例介绍eihealth-toolkit的使用过程，Linux和macOS环境使用方法基本相同，可参考。
假设“lmx-test-01”项目引用了来自“lmx-test-02”项目的数据，使用health switch project lmx-test-01命令进入“lmx-test-01”项目，使用health ls命令列举该项目下的对象。
- 指定“path”参数为根目录，查询根目录下所有对象。
health ls / -r # 返回结果如下 # *表示引用的其他项目中的数据 *lmx-test-02:/test1.txt *lmx-test-02:/test2.txt *lmx-test-02:/src1/ *lmx-test-02:/src1/test1.txt # Folder list为本项目中的数据 Folder list: /src1/ /src2/ File list: key size last_Modified /test1.txt 6.57MB 2020/11/09 10:32:12 /test2.txt 6.57MB 2020/11/09 10:32:12 /test3.txt 6.57MB 2020/11/09 10:32:12 /test4.txt 6.57MB 2020/11/09 10:32:12 /test5.txt 6.57MB 2020/11/09 10:32:12 /test6.txt 6.57MB 2020/11/09 10:32:12 /src1/test7.txt 6.57MB 2020/11/09 10:32:12 /src2/test8.txt 6.57MB 2020/11/09 10:32:12 Total size of current file is: 52.56MB Folder number is: 4 File number is: 8
- 指定“limit”参数，并只列举项目中的3个对象。
health ls --limit 3 # 返回结果如下 Folder list: /src1/ /src2/ File list: key Size LastModified /test1.txt 6.57MB 2020/11/09 10:32:12 Total size of current file is: 6.57MB Folder number is: 2 File number is: 1
- 指定“path”参数，列举某指定路径中的对象。
health ls /src2/ # 列举路径中的文件夹对象时，需使用/xxx/格式 # 返回结果如下 Folder list: /src2/ # 路径中无文件夹时，返回为空 File list: key Size LastModified /src2/test8.txt 6.57MB 2020/11/09 10:32:12 Total size of current file is: 6.57MB Folder number is: 1 File number is: 1
- 指定“simple”参数，以简略格式显示对象。
health ls --simple # 返回结果如下 Folder list: /src1/ /src2/ File list: /test1.txt /test2.txt /test3.txt /test4.txt /test5.txt /test6.txt /src1/test7.txt /src2/test8.txt Total size of current file is: 52.56MB Folder number is: 2 File number is: 8
- 指定引用项目。
health ls lmx-test-02:/src1/ --simple Start at 2022-08-23 08:28:43.3699574 +0000 UTC Listing objects . Folder list: Object list: /src1/test1.txt
