赛尔校园公共服务平台 Logo
平台使用
阿里云
百度云
移动云
智算服务
教育生态
登录 →
赛尔校园公共服务平台 Logo
平台使用 阿里云 百度云 移动云 智算服务 教育生态
登录
  1. 首页
  2. 阿里云
  3. 对象存储
  4. 开发参考
  5. 常用工具
  6. 命令行工具ossutil 2.0
  7. ossutil命令
  8. API级命令
  9. 关于Object操作
  10. 分片上传
  11. list-multipart-uploads

list-multipart-uploads

  • 分片上传
  • 发布于 2025-04-21
  • 0 次阅读
文档编辑
文档编辑

list-multipart-uploads用于列举所有执行中的Multipart Upload事件。

注意事项

调用list-multipart-uploads命令列举所有执行中的Multipart Upload事件指已经初始化但还未完成(Complete)或者还未中止(Abort)的Multipart Upload事件。

权限说明

阿里云账号默认拥有全部权限。阿里云账号下的RAM用户或RAM角色默认没有任何权限,需要阿里云账号或账号管理员通过RAM Policy或Bucket Policy授予操作权限。

API

Action

说明

ListMultipartUploads

oss:ListMultipartUploads

列举所有执行中的Multipart Upload事件,即已经初始化但尚未完成(Complete)或者尚未中止(Abort)的Multipart Upload事件。

命令格式

ossutil api list-multipart-uploads --bucket value [flags]
说明

list-multipart-uploads命令对应API接口ListMultipartUploads。关于API中的具体参数含义,请参见ListMultipartUploads。

参数

类型

说明

--bucket

string

Bucket名称。

--delimiter

string

对Object名字进行分组的字符。

--encoding-type

string

对返回的内容进行编码并指定编码的类型。

--max-uploads

int

返回的最大Upload个数。

--prefix

string

限定返回的Object Key必须以prefix作为前缀。

--upload-id-marker

string

与key-marker参数配合使用,用于指定返回结果的起始位置。

  • 如果未设置key-marker参数,则OSS会忽略upload-id-marker参数。

  • 如果设置了key-marker参数,查询结果中包含:

    • 所有Object名称的字典序大于key-marker参数值的Multipart Upload事件。

    • Object名称等于key-marker参数值,但是UploadId比upload-id-marker参数值大的Multipart Upload事件。

--key-marker

string

与upload-id-marker参数配合使用,用于指定返回结果的起始位置。

  • 如果未设置upload-id-marker参数,查询结果中包含所有Object名称的字典序大于key-marker参数值的Multipart Upload事件。

  • 如果设置了upload-id-marker参数,查询结果中包含:

    • 所有Object名称的字典序大于key-marker参数值的Multipart Upload事件。

    • Object名称等于key-marker参数值,但是UploadId比upload-id-marker参数值大的Multipart Upload事件。

说明

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

使用示例

  • 列举目标存储空间examplebucket所有正在执行的Multipart Upload事件。

    ossutil api list-multipart-uploads --bucket examplebucket
  • 列举目标存储空间examplebucket所有正在执行的Multipart Upload事件,以JSON格式显示。

    ossutil api list-multipart-uploads --bucket examplebucket --output-format json
  • 列举目标存储空间examplebucket所有正在执行的Multipart Upload事件,以YAML格式显示。

    ossutil api list-multipart-uploads --bucket examplebucket --output-format yaml
  • 列举目标存储空间examplebucket中指定前缀下dir下的Multipart Upload事件。

    ossutil api list-multipart-uploads --bucket examplebucket --prefix dir
  • 列举目标存储空间examplebucket中前100个Multipart Upload事件。

    ossutil api list-multipart-uploads --bucket examplebucket --max-uploads 100
  • 列举目标存储空间examplebucket中根目录下的Multipart Upload事件。

    ossutil api list-multipart-uploads --bucket examplebucket --delimiter /
  • 列举目标存储空间examplebucket中从test.txt之后按字母排序返回的Multipart Upload事件。

    ossutil api list-multipart-uploads --bucket examplebucket --key-marker test.txt
  • 列举目标存储空间examplebucket中所有 Multipart Upload事件,并对对象名字进行URL编码。

    ossutil api list-multipart-uploads --bucket examplebucket --encoding-type url
相关文章

initiate-multipart-upload 2025-04-21 17:24

initiate-multipart-upload用于通知OSS初始化一个Multipart Upload事件。 注意事项 调用接口会返回一个OSS服务器创建的全局唯一的Upload ID,用于标识本次Multipart Upload事件。您可以根据这个ID来发起相关的操

upload-part 2025-04-21 17:24

upload-part用于根据指定的Object名和uploadId来分块(Part)上传数据。 注意事项 调用upload-part上传Part数据前,必须先调用initiate-multipart-upload接口来获取OSS服务器生成的uploadId。 </

upload-part-copy 2025-04-21 17:24

upload-part-copy用于从一个已存在的Object中拷贝数据来上传一个Part。 注意事项 当拷贝一个大于1 GB的文件时,必须使用upload-part-copy的方式进行拷贝。如果想通过单个操作拷贝小于1 GB的文件,请参见copy-objec

complete-multipart-upload 2025-04-21 17:23

complete-multipart-upload用于完成整个文件的分片上传。 注意事项 调用 complete-multipart-upload 操作时,用户需提供所有有效的分片列表(含 PartNumber 和 ETag),PartNumber 范

abort-multipart-upload 2025-04-21 17:23

abort-multipart-upload用于取消MultipartUpload事件并删除对应的Part数据。 注意事项 您需要提供MultipartUpload事件相应的uploadId。

list-multipart-uploads 2025-04-21 17:23

list-multipart-uploads用于列举所有执行中的Multipart Upload事件。 注意事项 调用list-multipart-uploads命令列举所有执行中的Multipart Upload事件指已经初始化但还未完成(Complete)或者还未中止(Abort)的Multip

目录
Copyright © 2025 your company All Rights Reserved. Powered by 赛尔网络.
京ICP备14022346号-15
gongan beian 京公网安备11010802041014号