abort-multipart-upload

abort-multipart-upload用于取消MultipartUpload事件并删除对应的Part数据。

注意事项

  • 阿里云账号默认拥有取消MultipartUpload事件的权限。如果您需要通过RAM用户或者STS的方式进行取消,您必须拥有oss:AbortMultipartUpload权限。具体操作,请参见RAM用户授权自定义的权限策略

  • 您需要提供MultipartUpload事件相应的uploadId。

  • 取消一个MultipartUpload事件过程中,如果所属的某些Part仍然在上传,那么此次取消操作将无法删除这些Part。取消一个MultipartUpload事件后,您无法再使用此uploadId做任何操作,已经上传的Part数据也会被删除。

  • 建议您及时完成分片上传或者取消分片上传,因为已上传但是未完成或未取消的分片会占用存储空间,从而产生存储费用。

命令格式

ossutil api abort-multipart-upload --bucket examplebucket --key exampleobject --upload-id 123
说明

abort-multipart-upload命令对应API接口AbortMultipartUpload。关于API中的具体参数含义,请参见AbortMultipartUpload

参数

类型

说明

--bucket

string

Bucket名称。

--key

string

Object的完整路径。

--upload-id

string

MultipartUpload事件的ID。

说明

关于支持的全局命令行选项,请参见支持的全局命令行选项

使用示例

取消upload id123exampleobject对象的MultipartUpload事件并删除对应的Part数据。

ossutil api abort-multipart-upload --bucket examplebucket --key exampleobject --upload-id 123