list-multipart-uploads_对象存储(OSS)-阿里云帮助中心

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

注意事项

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

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

API	Action	说明

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
```