文档中心

对象存储

请输入

常用命令

删除桶、对象或分片上传任务（rm）

您可以使用 rm 命令删除桶及桶内的对象和分片任务。

删除桶

注意事项

删除存储桶前，请确保桶内的对象及分片均已删除。

删除资源时需要工具会提示您进行二次确认，取值说明如下：

y：表示确认删除。

n：表示不删除，不会执行删除操作。

命令格式

Linux/macOS

Windows

参数说明

通用可选参数的说明，请参见通用可选参数。

参数名	参数类型	描述
bucket	String	需要删除的桶名。
-f	Bool	强制操作，不进行询问提示。

使用示例

以下命令用于删除 bucketname1 存储桶。

命令

删除对象

注意

通过 tosutil 删除 HNS 桶中对象时，存在以下使用限制：

仅开启回收站功能后，才可删除目录（不包括回收站中目录）。

命令格式

Linux/macOS

Windows

删除单个对象

./tosutil rm tos://bucket/key [-f] [-versionId=xxx] [-fr] [-o=xxx] [-bt=xxx] [-e=xxx] [-re=xxx] [-i=xxx] [-k=xxx] [-t=xxx] [-conf=xxx]

批量删除对象

./tosutil rm tos://bucket/[prefix] -r [-f] [-j=1] [-v] [-o=xxx] [-bt=xxx] [-e=xxx] [-re=xxx] [-i=xxx] [-k=xxx] [-t=xxx] [-conf=xxx]

参数说明

通用可选参数的说明，请参见通用可选参数。

参数名	参数类型	描述
bucket	String	桶名。
key	String	对象名。
prefix	String	批量操作时的对象名前缀。
-r	Bool	执行批量删除操作。
-f	Bool	强制操作，不进行询问提示。
-fr	Bool	删除单个对象或单个分片上传任务时生成结果清单文件。
-j	Integer	批量任务的最大并发数，默认为配置文件中的 defaultJobs。
-v	Bool	按指定的对象名前缀批量删除多版本对象和多版本删除标记。
-versionId	String	待删除的单个对象的版本号。
-o	String	生成结果清单文件的文件夹，默认为配置文件中的 defaultOutputDir。
-bt	String	存储桶的类型。取值说明如下： fns：扁平桶。 hns：分层桶。如果未指定存储桶的类型，则默认从桶元数据获取存储桶的类型。

使用示例

删除单个对象

以下命令用于删除 bucketname 桶内的 object1.png 对象。

命令

./tosutil rm tos://bucketname/object1.png

Do you want delete object [object1.png] in the bucket [bucketname]? Please input (y/n) to confirm:
y
Start at 2022-10-27 11:03:01.983467 +0000 UTC

Delete object [object1.png] in the bucket [bucketname] successfully, cost [92], request id [76bf485a65668d09635a6566-ac1ea1cc-1oo0f8-DO-cb-tos-bj]

批量删除对象

以下命令用于删除 bucketname 桶内的前缀为 object 的对象。

命令

./tosutil rm tos://bucketname/object -r

Do you want start to delete objects using the prefix [object] in the bucket [bucketname] ? Please input (y/n) to confirm:
y
Start at 2022-10-27 11:03:22.970964 +0000 UTC

[--------------------------------------------------] 100.00% tps:0.00 3/3 159ms
Succeed count is: 3 Failed count is: 0
Metrics [max cost:92 ms, min cost:90 ms, average cost:91.00 ms, average tps:18.40]

Task id is: f93dea58-55e6-11ed-9e20-aa665a3c7f26

删除分片上传任务

命令格式

Linux/macOS

Windows

删除单个分片上传任务

./tosutil rm tos://bucket/key -m -u=xxx [-f] [-fr] [-o=xxx] [-e=xxx] [-re=xxx] [-i=xxx] [-k=xxx] [-t=xxx] [-conf=xxx]

批量删除分片上传任务

./tosutil rm tos://bucket/[prefix] -m -r [-f] [-j=1] [-o=xxx] [-e=xxx] [-re=xxx] [-i=xxx] [-k=xxx] [-t=xxx] [-conf=xxx]

参数说明

通用可选参数的说明，请参见通用可选参数。

参数名	参数类型	描述
bucket	String	桶名。
key	String	对象名。
prefix	String	批量操作时的对象名前缀。
-r	Bool	执行批量删除操作。
-f	Bool	强制操作，不进行询问提示。
-fr	Bool	删除单个对象或单个分片上传任务时生成结果清单文件。
-j	Integer	批量任务的最大并发数，默认为配置文件中的 defaultJobs。
-v	Bool	按指定的对象名前缀批量删除多版本对象和多版本删除标记。
-m	Bool	删除分片上传任务模式。
-u	String	待删除的单个分片上传任务的 ID。说明您可以通过 ls 命令列举分片任务 ID。
-o	String	生成结果清单文件的文件夹，默认为配置文件中的 defaultOutputDir。

使用示例

删除单个分片上传任务

以下命令用于删除任务 ID 为 6b2292652f8fedf496f5495a6668**** 的分片上传任务。

命令

./tosutil rm tos://bucketname/安装包/Postman.app/Contents/Resources/app.asar -m -u=6b2292652f8fedf496f5495a6668****

Do you want abort multipart upload [安装包/Postman.app/Contents/Resources/app.asar] in the bucket [bucketname] ? Please input (y/n) to confirm:
y
Start at 2022-10-27 11:12:35.619554 +0000 UTC

Abort multipart upload [安装包/Postman.app/Contents/Resources/app.asar] in the bucket [bucketname] successfully, cost [147], request id [76bf485a67a3bac0635a67a3-ac1ea1cc-1oo0oN-AMU-cb-tos-bj]

批量删除分片上传任务

命令

./tosutil rm tos://bucketname/Visual -m -r

Do you want start to abort multipart uploads using the prefix [Visual] in the bucket [bucketname] ? Please input (y/n) to confirm:
y
Start at 2022-10-27 09:52:18.41894 +0000 UTC

[--------------------------------------------------] 100.00% tps:0.00 2/2 137ms
Succeed count is: 2 Failed count is: 0
Metrics [max cost:97 ms, min cost:51 ms, average cost:74.00 ms, average tps:14.18]

Task id is: 0b5ee390-55dd-11ed-b7d9-aa665a3c7f26

说明

更多删除场景的示例命令，请参见删除示例。

最近更新时间：2025.10.15 19:14:53

这个页面对您有帮助吗？

有用

无用