lsparts 命令列出分块上传中产生的文件碎片。
注意:更多授权请参见 支持 CAM 的业务接口
一、命令格式
./coscli lsparts cos://<bucket-name>[/prefix/] [flag]
lsparts 命令包含以下参数:
| 参数格式 | 参数用途 | 示例 |
| cos://<bucket-name> | 指定需要访问的存储桶。支持使用 配置参数 中的桶别名,或桶名称进行访问。如使用桶名称访问,需要额外携带 endpoint flag。 | 使用桶别名访问:cos://example-alias使用桶名称访问:cos://examplebucket-1250000000 |
| /prefix/ | 可选参数。指定某一文件夹 | /picture/ |
lsparts 命令包含以下可选 flag:
| flag 简写 | flag 全称 | flag 用途 |
| -h | –help | 查看该命令的具体用法 |
| 无 | –include | 包含特定模式的文件 |
| 无 | –exclude | 排除特定模式的文件 |
| 无 | –limit | 指定列出的最大数量(0 – 1000) |
| 无 | –upload-id | 上传记录 id。当传入 uploadid 时,需指定具体文件,仅展示 uploadid 对应的文件碎片信息,未传入 uploadid 时,展示指定 prefix 下正在进行中的分块上传任务 |
注意:说明:
二、列出 bucket1桶内的所有正在进行中的分块上传任务
./coscli lsparts cos://bucket1
返回的结果示例如下,输出的信息包括:对象键(对象在存储桶中的唯一标识)、分块上传的 ID、分块上传的起始时间、桶内碎片总数量。
KEY | UPLOAD ID | INITIATE TIME—————+————————————-+—————————- test.txt | 1671191183635d2b71b1d68a0********** | 2022-01-01T00:00:00.000Z—————+————————————-+—————————- TOTAL: 1 —————————-
三、列出 bucket1桶内 test.txt 文件 upload_id 为 1671191183635d2b71b1d68a0********** 的所有上传碎片
./coscli lsparts cos://bucket1/test.txt –upload-id="1671191183635d2b71b1d68a0**********"
返回的结果示例如下,输出的信息包括:PARTNUMBER(块的编号)、ETAG(块的 MD-5 算法校验值)、LastModified(分块最后被修改时间)、SIZE(分块大小)。
PARTNUMBER | ETAG | LAST MODIFIED | SIZE ————-+————————————+—————————+———— 1 | "58f06dd588d8ffb3beb46ada6309436b" | 2024-12-17T16:34:48+08:00 | 32.00 MB 2 | "58f06dd588d8ffb3beb46ada6309436b" | 2024-12-17T16:34:48+08:00 | 32.00 MB 3 | "58f06dd588d8ffb3beb46ada6309436b" | 2024-12-17T16:34:48+08:00 | 32.00 MB 4 | "58f06dd588d8ffb3beb46ada6309436b" | 2024-12-17T16:34:48+08:00 | 32.00 MB ————-+————————————+—————————+———— TOTAL: 4 ————-