list-multipart-uploads - Object Storage Service - Alibaba Cloud Documentation Center

Lists all ongoing multipart upload tasks.

Usage notes

Ongoing multipart upload tasks specify the tasks that are initialized but not completed or canceled.

Permissions

By default, an Alibaba Cloud account has full permissions. RAM users or RAM roles under an Alibaba Cloud account do not have any permissions by default. The Alibaba Cloud account or account administrator must grant operation permissions through RAM Policy or Bucket Policy.

API	Action	Definition
ListMultipartUploads	`oss:ListMultipartUploads`	Lists all ongoing multipart upload events, which are multipart upload events that have been initialized but not yet completed or aborted.

Command syntax

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

Note

The list-multipart-uploads command corresponds to the ListMultipartUploads operation. For more information about the parameters in the ListMultipartUploads operation, see ListMultipartUploads.

Parameter	Type	Description
--bucket	string	The name of the bucket.
--delimiter	string	The character used to group objects by name.
--encoding-type	string	The encoding type of the object names in the response.
--max-uploads	int	The maximum number of multipart upload tasks returned by OSS.
--prefix	string	The prefix that the names of returned objects must contain.
--upload-id-marker	string	The upload ID of the multipart upload task after which the listing begins. This parameter is used together with the key-marker parameter. If the key-marker parameter is not set, OSS ignores the upload-id-marker parameter. If the key-marker parameter is set, the query result includes: Multipart upload tasks in which object names are alphabetically after the value of the key-marker parameter. Multipart upload tasks in which object names are the same as the value of the key-marker parameter but whose upload IDs are greater than the value of the upload-id-marker parameter.
--key-marker	string	This parameter is used together with the upload-id-marker parameter to specify the position from which the returned results start. If the upload-id-marker parameter is not set, OSS returns all multipart upload tasks in which object names are alphabetically after the value of the key-marker parameter. If the upload-id-marker parameter is set, the response includes the following tasks: Multipart upload tasks in which object names are alphabetically after the value of the key-marker parameter. Multipart upload tasks in which object names are the same as the value of the key-marker parameter but whose upload IDs are greater than the value of the upload-id-marker parameter.

Note

For more information about supported global command-line options, see Global command-line options.

Examples

List all ongoing multipart upload tasks in a bucket named examplebucket.
```
ossutil api list-multipart-uploads --bucket examplebucket
```
List all ongoing multipart upload tasks in a bucket named examplebucket and display the list results in the JSON format.
```
ossutil api list-multipart-uploads --bucket examplebucket --output-format json
```
List all ongoing multipart upload tasks in a bucket named examplebucket and display the list results in the YAML format.
```
ossutil api list-multipart-uploads --bucket examplebucket --output-format yaml
```
List all ongoing multipart upload tasks whose names contain the dir prefix in the bucket named examplebucket.
```
ossutil api list-multipart-uploads --bucket examplebucket --prefix dir
```
List the first 100 ongoing multipart upload tasks in a bucket named examplebucket.
```
ossutil api list-multipart-uploads --bucket examplebucket --max-uploads 100
```
List all ongoing multipart upload tasks in the root directory of a bucket named examplebucket.
```
ossutil api list-multipart-uploads --bucket examplebucket --delimiter /
```
List all ongoing multipart upload tasks whose names are alphabetically after test.txt in a bucket named examplebucket.
```
ossutil api list-multipart-uploads --bucket examplebucket --key-marker test.txt
```
List all ongoing multipart upload tasks in a bucket named examplebucket and URL-encode the object names.
```
ossutil api list-multipart-uploads --bucket examplebucket --encoding-type url
```