S3 list multipart uploads

Edit online

GET /?uploads returns a list of the current in-progress multipart uploads, that is, the application initiates a multipart upload, but the service hasn’t completed all the uploads yet.

Syntax

GET /_BUCKET_?uploads HTTP/1.1

You can specify parameters for GET /_BUCKET_?uploads, but none of them are required.

Parameters

prefix

Description: Returns in-progress uploads whose keys contain the specified prefix.
Type: String

delimiter

Description: The delimiter between the prefix and the rest of the object name.
Type: String

key-marker

Description: The beginning marker for the list of uploads.
Type: String

max-keys

Description: The maximum number of in-progress uploads. The default is 1000.
Type: Integer

max-uploads

Description: The maximum number of multipart uploads. The range is from 1-1000. The default is 1000.
Type: Integer

version-id-marker

Description: Ignored if key-marker isn’t specified. Specifies the ID of the first upload to list in lexicographical order at or following the ID.
Type: String

Response Entities

ListMultipartUploadsResult

Description: A container for the results.
Type: Container

ListMultipartUploadsResult.Prefix

Description: The prefix specified by the prefix request parameter, if any.
Type: String

Bucket

Description: The bucket that will receive the bucket contents.
Type: String

KeyMarker

Description: The key marker specified by the key-marker request parameter, if any.
Type: String

UploadIdMarker

Description: The marker specified by the upload-id-marker request parameter, if any.
Type: String

NextKeyMarker

Description: The key marker to use in a subsequent request if IsTruncated is true.
Type: String

NextUploadIdMarker

Description: The upload ID marker to use in a subsequent request if IsTruncated is true.
Type: String

MaxUploads

Description: The max uploads specified by the max-uploads request parameter.
Type: Integer

Delimiter

Description: If set, objects with the same prefix will appear in the CommonPrefixes list.
Type: String

IsTruncated

Description: If true, only a subset of the bucket’s upload contents were returned.
Type: Boolean

Upload

Description: A container for Key, UploadId, InitiatorOwner, StorageClass, and Initiated elements.
Type: Container

Key

Description: The key of the object once the multipart upload is complete.
Type: String

UploadId

Description: The ID that identifies the multipart upload.
Type: String

Initiator

Description: Contains the ID and DisplayName of the user who initiated the upload.
Type: Container

DisplayName

Description: The initiator’s display name.
Type: String

ID

Description: The initiator’s ID.
Type: String

Owner

Description: A container for the ID and DisplayName of the user who owns the uploaded object.
Type: Container

StorageClass

Description: The method used to store the resulting object. STANDARD or REDUCED_REDUNDANCY
Type: String

Initiated

Description: The date and time the user initiated the upload.
Type: Date

CommonPrefixes

Description: If multiple objects contain the same prefix, they will appear in this list.
Type: Container

CommonPrefixes.Prefix

Description: The substring of the key after the prefix as defined by the prefix request parameter.
Type: String