All Products
Search

This Product

    Object Storage Service:list-multipart-uploads

    Document Center

    Object Storage Service:list-multipart-uploads

    Last Updated:Mar 20, 2026

    Lists all ongoing multipart uploads in a bucket — uploads that have been initiated but not yet completed or aborted.

    Usage notes

    Incomplete multipart uploads occupy storage space and incur storage costs. Use this command to identify them so you can complete or abort them.

    Permissions

    By default, an Alibaba Cloud account has full permissions. RAM users and RAM roles have no permissions by default. Grant the required permissions through RAM Policy or Bucket Policy.

    APIActionDescription
    ListMultipartUploadsoss:ListMultipartUploadsLists all ongoing multipart uploads — uploads that have been initiated but not yet completed or aborted.

    Command syntax

    ossutil api list-multipart-uploads --bucket <bucket-name> [flags]
    This command maps to the ListMultipartUploads API operation. For parameter details, see ListMultipartUploads.

    Parameters

    ParameterTypeDescription
    --bucketstringThe name of the bucket. Required.
    --prefixstringFilters results to uploads whose object names start with the specified prefix.
    --delimiterstringGroups object names by the specified character. Use / to list uploads in the root directory only.
    --max-uploadsintThe maximum number of multipart upload tasks returned by OSS.
    --key-markerstringReturns uploads whose object names are alphabetically after this value. Use with --upload-id-marker for pagination. If --upload-id-marker is not set, OSS returns all uploads with object names alphabetically after this value.
    --upload-id-markerstringWorks with --key-marker to set the pagination start position. If --key-marker is not set, OSS ignores this parameter. When both are set, results include uploads whose object names are alphabetically after --key-marker, plus any uploads with the same object name as --key-marker whose upload IDs are greater than --upload-id-marker.
    --encoding-typestringThe encoding format for object names in the response. Set to url to URL-encode object names.

    For supported global flags, see Global command-line options.

    Examples

    List all ongoing multipart uploads in a bucket

    ossutil api list-multipart-uploads --bucket examplebucket
    Incomplete multipart uploads incur storage costs. Complete or abort any uploads you no longer need.

    Return results in JSON format

    ossutil api list-multipart-uploads --bucket examplebucket --output-format json

    Return results in YAML format

    ossutil api list-multipart-uploads --bucket examplebucket --output-format yaml

    Filter by prefix

    Lists uploads whose object names start with dir:

    ossutil api list-multipart-uploads --bucket examplebucket --prefix dir

    Limit the number of results

    Lists the first 100 uploads:

    ossutil api list-multipart-uploads --bucket examplebucket --max-uploads 100

    List uploads in the root directory only

    ossutil api list-multipart-uploads --bucket examplebucket --delimiter /

    Paginate results

    Lists uploads whose object names are alphabetically after test.txt:

    ossutil api list-multipart-uploads --bucket examplebucket --key-marker test.txt

    URL-encode object names

    ossutil api list-multipart-uploads --bucket examplebucket --encoding-type url