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

list-parts

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

list-parts用于列举指定Upload ID所属的所有已经上传成功的Part。

注意事项

  • OSS的返回结果按照Part号码升序排列。

  • 由于网络传输可能出错,所以不推荐使用list-parts来返回结果中的Part Number和ETag值来生成已经上传成功的Part列表。

权限说明

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

API

Action

说明

ListParts

oss:ListParts

列举指定Upload ID所属的所有已经上传成功的Part。

命令格式

ossutil api list-parts --bucket value --key value --upload-id value [flags]

参数

类型

说明

--bucket

string

Bucket名称。

--key

string

Object的完整路径。

--encoding-type

string

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

--max-parts

int

规定在OSS响应中的最大Part数目。

--part-number-marker

int

指定List的起始位置,只有Part Number数目大于该参数的Part会被列出。

--upload-id

string

MultipartUpload事件的ID。

说明
  • list-parts命令对应API接口ListParts。关于API中的具体参数含义,请参见ListParts。

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

使用示例

  • 列举目标存储空间examplebucket名字为exampleobject且Upload ID是123的所有已经上传成功Part。

    ossutil api list-parts --bucket examplebucket --key exampleobject --upload-id 123
  • 列举目标存储空间examplebucket名字为exampleobject且Upload ID是123的所有已经上传成功Part,以JSON格式显示。

    ossutil api list-parts --bucket examplebucket --key exampleobject --upload-id 123 --output-format json
  • 列举目标存储空间examplebucket名字为exampleobject且Upload ID是123的所有已经上传成功Part,以YAML格式显示。

    ossutil api list-parts --bucket examplebucket --key exampleobject --upload-id 123 --output-format yaml
  • 列举目标存储空间examplebucket中前 100 个Part。

    ossutil api list-parts --bucket examplebucket --key exampleobject --upload-id 123 --max-parts 100
  • 列举目标存储空间examplebucket中所有Part,并对对象名字进行URL编码。

    ossutil api list-parts --bucket examplebucket --key exampleobject --upload-id 123 --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号