Spectra Logic

1-800-833-1132 : 1-303-449-6400

List Multipart Uploads

Description

Lists and gives information about multipart uploads currently in progress for the specified bucket. This is an Amazon S3 compatible operation.

See List Multipart Uploads for Amazon S3 operation details.

Requests

Syntax

GET http[s]://{datapathDNSname}/{bucket}?uploads​[&delimiter={string}][&key_marker={64‑bit integer}]​[&max_uploads={64‑bit integer}][&prefix={string}]​[&upload_id_marker={string}]

Request Parameters

Parameter	Description	Required
uploads	Indicates that this operation initiates a multipart upload.	yes
delimiter	A character used to group object names.	no
key_marker	Together with upload_id_marker, this parameter specifies the multipart upload after which listing should begin. If upload_id_marker is not specified, only the keys lexicographically greater than the specified key_marker are included in the list. If upload_id_marker is specified, any multipart uploads for a key equal to the key_marker are included if the multipart uploads have upload IDs lexicographically greater than the specified upload_id_marker.	no
max_uploads	Maximum number of uploads to include in the response.	no
prefix	Limits the response to object names that begin with the specified prefix. If a delimiter is specified, unique text strings before the delimiter in object names are considered prefixes.	no
upload_id_marker	Together with key_marker, specifies the multipart upload after which listing should begin. If key_marker is not specified, this parameter is ignored. Otherwise, any multipart uploads for a key equal to the key_marker are included in the list if they have an upload ID lexicographically greater than the specified upload_id_marker.	no

Responses

Response Elements

<ListMultipartUploadsResult>
   <Bucket>{string}</Bucket>
   <Delimiter>{string}</Delimiter>
   <IsTruncated>TRUE|FALSE</IsTruncated>
   <KeyMarker>{string}</KeyMarker>
   <MaxUploads>{64‑bit integer}</MaxUploads>
   <NextKeyMarker>{string}</NextKeyMarker>
   <NextUploadIdMarker>{string}</NextUploadIdMarker>
   <Prefix>{string}</Prefix>
   <Upload>
      <Initiated>{YYYY-MM-DDThh:mm:ss.xxxZ}</Initiated>
      <Key>{string}</Key>
      <Owner>
         <DisplayName>{string}</DisplayName>
         <ID>{string}</ID>
      </Owner>
      <UploadId>{string}</UploadId>
   </Upload>
   ...
   <UploadIdMarker>{string}</UploadIdMarker>
</ListMultipartUploadsResult>

where the response elements are defined as follows:

Parameter	Description
ListMultipart UploadsResult	The container for the response.
Bucket	The name for the bucket in which the object resides.
Delimiter	The character used to group object names.
IsTruncated	Specifies whether the results were truncated (TRUE) or not (FALSE) due to the number of results exceeding MaxParts. Values: TRUE, FALSE
KeyMarker	The key at or after which the listing began.
MaxUploads	Maximum number of uploads included in the response.
NextKeyMarker	When the list is truncated, this element specifies the value to use for the key_marker request parameter in a subsequent request.
NextUploadId Marker	When the list is truncated, this element specifies the value to use for the upload_id_marker request parameter in a subsequent request.
Prefix	The string used to limit the response keys. Only object names that begin with the specified prefix are listed.
Upload	The container for information about one upload.
Initiated	Date and time when the multipart upload was initiated in the format YYYY-MM-DDThh:mm:ss.xxxZ.
Key	The name of the object for which the multipart upload was initiated.
Owner	The container for information about the owner.
DisplayName	The username for the owner.
ID	The UUID for the owner.
UploadID	The UUID for the multipart upload.
UploadIdMarker	Upload ID after which listing began.

Example

Sample Request

This request gets a list of the multipart uploads in-progress for bucket1.

GET http[s]://blackpearl-hostname/bucket1?uploads HTTP/1.1

Sample Response

HTTP/1.1 200 OK
<ListMultipartUploadsResult>
   <Bucket>bucket1</Bucket>
   <Delimiter/>
   <IsTruncated>FALSE</IsTruncated>
   <KeyMarker>test_object_1</KeyMarker>
   <MaxUploads>1000</MaxUploads>
   <NextKeyMarker/>
   <NextUploadIdMarker/>
   <Prefix/>
   <Upload>
      <Initiated>2015-02-12T17:28:41.000Z</Initiated>   
      <Key>test_object_2</Key>
      <Owner>
         <DisplayName>user_name</DisplayName>
         <ID>2d7a060f-640a-4186-875f-e413a47a85c2</ID>
      </Owner>
      <UploadId>870c99ca-9d94-4e2f-a344-2596d1ebdaf4</UploadId>
   </Upload>
   <UploadIdMarker/>
</ListMultipartUploadsResult>