Riak CS List Multipart Uploads

Lists multipart uploads that have not yet been completed or aborted.

In the response, the uploads are sorted by key. If your application has initiated more than one multipart upload using the same object key, then uploads in the response are first sorted by key. Additionally, uploads are sorted in ascending order within each key by the upload initiation time.

Requests

Request Syntax

This example shows the syntax for listing of multipart uploads.

GET /?uploads HTTP/1.1
Host: bucketname.data.riak.com
Date: date
Authorization: signatureValue

Request Parameters

delimiter - Character you use to group keys.

  • Type: String

max-uploads - Sets the maximum number of multipart uploads, from 1 to 1,000, to return in the response body.

  • Type: Integer
  • Default: 1,000

key-marker - Together with upload-id-marker, this parameter specifies the multipart upload after which listing should begin.

  • Type: String

prefix - Lists in-progress uploads only for those keys that begin with the specified prefix.

  • Type: String

upload-id-​marker - Together with key-marker, specifies the multipart upload after which listing should begin.

  • Type: String

Request Headers

This implementation of the operation uses only response headers that are common to most responses. For more information, see Common RiakCS Response Headers.

Request Elements

This operation does not use request elements.

Response

Response Headers

This implementation of the operation uses only response headers that are common to most responses. For more information, see Common RiakCS Response Headers.

Response Elements

ListMultipartUploadsResult - Container for the response.

  • Type: Container
  • Children: Bucket, KeyMarker, UploadIdMarker, NextKeyMarker, NextUploadIdMarker, MaxUploads, Delimiter, Prefix, CommonPrefixes, IsTruncated
  • Ancestors: None

Bucket - Name of the bucket to which the multipart upload was initiated.

  • Type: String
  • Ancestors: ListMultipartUploadsResult

KeyMarker - The key at or after which the listing began.

  • Type: String
  • Ancestors: ListMultipartUploadsResult

UploadIdMarker - Upload ID after which listing began.

  • Type: String
  • Ancestors: ListMultipartUploadsResult

NextKeyMarker - When a list is truncated, this element specifies the value that should be used for the key-marker request parameter in a subsequent request.

  • Type: Container
  • Ancestors: ListMultipartUploadsResult

NextUploadIdMarker - When a list is truncated, this element specifies the value that should be used for the upload-id-marker request parameter in a subsequent request.

  • Type: String
  • Ancestors: ListMultipartUploadsResult

MaxUploads - Maximum number of multipart uploads that could have been included in the response.

  • Type: Integer
  • Ancestors: ListMultipartUploadsResult

IsTruncated - Indicates whether the returned list of parts is truncated.

  • Type: Boolean
  • Ancestors: ListPartsResult

Upload - Container for elements related to a particular multipart upload.

  • Type: Container
  • Children: Key, UploadId, InitiatorOwner, StorageClass, Initiated
  • Ancestors: ListMultipartUploadsResult

Key - Key of the object for which the multipart upload was initiated.

  • Type: Integer
  • Ancestors: Upload

UploadId - Upload ID that identifies the multipart upload.

  • Type: Integer
  • Ancestors: Upload

Initiator - Container element that identifies who initiated the multipart upload.

  • Type: Container
  • Children: ID, DisplayName
  • Ancestors: Upload

ID - Canonical User ID.

  • Type: String
  • Ancestors: Initiator, Owner

DisplayName - Principal’s name.

  • Type: String
  • Ancestors: Initiator, Owner

Owner - Container element that identifies the object owner, after the object is created.

  • Type: Container
  • Children: ID, DisplayName
  • Ancestors: Upload

Initiated - Date and time at which the multipart upload was initiated.

  • Type: Date
  • Ancestors: Upload

ListMultipartUploadsResult.Prefix - When a prefix is provided in the request, this field contains the specified prefix.

  • Type: String
  • Ancestors: ListMultipartUploadsResult

Delimiter - Contains the delimiter you specified in the request.

  • Type: String
  • Ancestors: ListMultipartUploadsResult

CommonPrefixes - If you specify a delimiter in the request, then the result returns each distinct key prefix containing the delimiter in a CommonPrefixes element.

  • Type: Container
  • Ancestors: ListMultipartUploadsResult

CommonPrefixes.Prefix - If the request does not include the Prefix parameter, then this element shows only the substring of the key that precedes the first occurrence of the delimiter character. These keys are not returned anywhere else in the response.

  • Type: String
  • Ancestors: CommonPrefixes

Examples

Sample Request

The following request lists three multipart uploads.

GET /?uploads HTTP/1.1
Host: os.data.riak.com
Date: Mon, 1 Nov 2010 20:34:56 GMT
Authorization: AWS AKIAIOSFODNN7EXAMPLE:0RQf4/cRonhpaBX5sCYVf1bNRuU=

Sample Response

HTTP/1.1 200 OK
Date: Mon, 1 Nov 2010 20:34:56 GMT
Content-Length: 1330
Connection: keep-alive
Server: MochiWeb/1.1 WebMachine/1.9.0 (someone had painted it blue)

<?xml version="1.0" encoding="UTF-8"?>
<ListMultipartUploadsResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
  <Bucket>os</Bucket>
  <KeyMarker></KeyMarker>
  <UploadIdMarker></UploadIdMarker>
  <NextKeyMarker>large.iso</NextKeyMarker>
  <NextUploadIdMarker></NextUploadIdMarker>
  <MaxUploads></MaxUploads>
  <IsTruncated></IsTruncated>
  <Upload>
    <Key>my-divisor</Key>
    <UploadId>VXBsb2FkIElEIGZvciA2aWWpbmcncyBteS1tb3ZpZS5tMnRzIHVwbG9hZA</UploadId>
    <Initiator>
      <ID>arn:aws:iam::111122223333:user/user1-11111a31-17b5-4fb7-9df5-b111111f13de</ID>
      <DisplayName>user1-11111a31-17b5-4fb7-9df5-b111111f13de</DisplayName>
    </Initiator>
    <Owner>
      <ID>75aa57f09aa0c8caeab4f8c24e99d10f8e7faeebf76c078efc7c6caea54ba06a</ID>
      <DisplayName>OwnerDisplayName</DisplayName>
    </Owner>
    <StorageClass>STANDARD</StorageClass>
    <Initiated>2010-11-10T20:48:33.000Z</Initiated>
  </Upload>
  ...
</ListMultipartUploadsResult>