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

注意事项

阿里云账号默认拥有列举所有执行中的Multipart Upload事件的权限。如果您需要通过RAM用户或者STS的方式进行列举，您必须拥有oss:ListMultipartUploads权限。具体操作，请参见为RAM用户授权自定义的权限策略。
调用list-multipart-uploads命令列举所有执行中的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
```