S3 Bucket List Uploads Operations:List Multipart Uploads

Search (SHIFT+S)




List Multipart Uploads

GET /?uploads

List multipart uploads that are in-progress. A multipart upload in-progress is one that has been initiated using the Initiate Multipart Upload request but hasn't yet aborted or completed. This will return in the response at most 1,000 multipart uploads

URL Format

Host Style: http://bucketname.ns1.emc.com/?uploads
Path Style: http://ns1.emc.com/bucketname?uploads

Request Headers

x-amz-date optionalThe timestamp of the request added by the requester. Example: Tue, 03 Sept 2013 12:00:00 GMT. If the Authorization header is specified then you must specify either the x-amz-date or the Date header. If both the headers are specified then the value of x-amz-date header is chosen.
Authorization requiredInformation needed to authenticate requests.

Prerequisites

The following conditions must be met in order to call this operation.

  • BaseUrl used in a host-style request URL should be pre-configured using the ECS Management API or the ECS Portal (for example, emc.com in the URL: bucketname.ns1.emc.com).

  • Namespace corresponding to this bucket should exist (for example, ns1)


Response Body

Field Description Type Notes
<ListMultipartUploadsResult>
<Bucket> The bucket's name in which the multipart upload was intitated String
<KeyMarker> Key after or at which the listing began String
<UploadIdMarker> The upload ID after which the listing began String
<NextKeyMarker> This specifies the value for the key-marker query parameter for the subsequent request if the list in truncated String
<NextUploadIdMarker> This specifies the value for the upload-id-marker query parameter for the subsequent request if the list in truncated String
<MaxUploads> The maximum number of multipart uploads which could have been included in the response Integer Valid Values:
  •  Integer
<IsTruncated> Indicates whether the list of multipart uploads was truncated(true) or not(false). The list can be truncated if the number of multipart uploads is more than the limit allowed or that specified by MaxUploads Boolean Valid Values:
  •  true = truncated
  •  false = not truncated
<Upload>     0-* Elements
<Key> The object's key for which the multipart upload was initiated String Valid Values:
  •  Integer
<UploadId> The upload ID identifying the multipart upload String Valid Values:
  •  Integer
<RequestInitiator>    
<ID> User ID of the user who initiated the multipart upload String
<DisplayName> The screen name of the user String
</RequestInitiator>      
<Owner>    
<ID> The ID of the bucket owner String
<DisplayName> Screen name of the owner of the bucket. String
</Owner>      
<StorageClass> Identifies the class of storage which will be used to store the object after the completion of the multipart upload String
<Initiated> The timestamp of the initiation of the multipart upload Date Valid Values:
  •  Date in 8601 format
</Upload>      
<Prefix> If the request contains the prefix then the result will only contain the keys that start with the specified prefix String
<Delimiter> Indicates the delimiter, if mentioned in the request. If the delimiter is not specified in the request then this element is absent in the response. String
<CommonPrefixes>     0-* Elements
<Prefix> If the request does not include the prefix parameter then this shows only the substring of the key before the first occurrence of the delimiter If the request includes the prefix parameter then this shows the substring of the key from the beginning of the prefix to the first occurrence of the delimiter String
</CommonPrefixes>      
</ListMultipartUploadsResult>
Notes: