列出分块上传中产生的碎片 - lsparts

2025-11-03   访问量:0

lsparts 命令列出分块上传中产生的文件碎片。

注意:

如需用此命令列出分块上传任务,在您进行 授权策略 时,action 需要设置为 cos:PutBucket

如需使用此命令列出分块上传任务对应的文件碎片,在您进行 授权策略 时,action 需要设置为 cos:ListMultipartUploadscos:ListParts

更多授权请参见 支持 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  

                                                                             -------------






热门文章
更多>