1. Oracle ZFS Storage Appliance Object API Guide for Amazon S3 Service Support, Release OS8.8.x
  2. S3 Object API Operation Command Reference
  3. Operations on Objects
  4. List Multipart Uploads

List Multipart Uploads

The List Multipart Uploads operation lists in-progress multipart uploads that were started with the Initiate Multipart Upload request, but have not completed nor aborted. The default and maximum number of multipart uploads is 1000. To restrict the number of uploads returned, use the max-uploads request parameter, with a value from 1 to 1000. If the number of in-progress uploads exceeds the list's limit, response field IsTruncated is set to true, and the response includes elements key-marker and upload-id-marker, which can be used in a subsequent List Multipart Uploads request.

Syntax Example

Request syntax example for List Mulitpart Uploads:

GET https://appliance:443/s3/v1/export/share_mount_point_path/bucket_name?uploads&delimiter=Delimiter&encoding-type=EncodingType&key-marker=KeyMarker&max-uploads=MaxUploads&prefix=Prefix&upload-id-marker=UploadIdMarker

Request Parameters

This implementation of the List Multipart Uploads operation supports the following request parameters, as described in List Multipart Uploads:

  • delimiter

  • encoding-type

  • key-marker

  • max-uploads

  • prefix

  • upload-id-marker

Request Headers

This implementation of the List Multipart Uploads operation supports the following request header, as described in Supported Common Request Headers: x-amz-expected-bucket-owner.

Request Elements

This implementation of the List Multipart Uploads operation does not support the use of request elements.

Response Headers

This implementation of the List Multipart Uploads operation supports response headers that are common to all operations, as described in table "Common Supported Response Headers" in Supported Common Response Headers.

Response Elements

For the List Multipart Uploads operation, the following response elements are supported, as described in List Multipart Uploads:

  • Bucket

  • CommonPrefixes

  • Delimiter

  • EncodingType

  • IsTruncated

  • KeyMarker

  • ListMultipartUploadsResult

  • MaxUploads

  • NextKeyMarker

  • NextUploadIdMarker

  • Prefix

  • Upload

  • UploadIdMarker

Expected HTTP Response Code

200 OK

Error Response Code

The List Multipart Uploads operation does not return special errors. For general information about S3 errors and a list of error codes, see S3 Client Error Handling Reference.

Example

GET ?uploads&max-uploads=3&key-marker=apple.jpg HTTP/1.1
x-amz-date: Mon, 17 Apr 2023 20:04:21 GMT
Authorization: authorization string

HTTP/1.1 200 OK
x-amz-request-id:txa3b321e1a34d4628a6546-00644896f0
Date: Mon, 17 Apr 2023 20:05:21 GMT
Content-Length: 733
<ListMultipartUploadsResult>
  <Bucket>example-bucket</Bucket>
  <KeyMarker>apple.jpg</KeyMarker>
  <UploadIdMarker></UploadIdMarker>
  <NextKeyMarker>banana.jpg</NextKeyMarker>
  <NextUploadIdMarker>43fff991-1e1b-4088-9753-d0bd0b7439ca</NextUploadIdMarker>
  <MaxUploads>1</MaxUploads>
  <IsTruncated>true</IsTruncated>
  <Upload>
    <Key>banana.jpg</Key>
    <UploadId>43fff991-1e1b-4088-9753-d0bd0b7439ca</UploadId>
    <Initiator>
      <ID>user_terster</ID>
      <DisplayName>user_tester</DisplayName>
    </Initiator>
    <Owner>
      <ID>user_tester</ID>
      <DisplayName>user_tester</DisplayName>
    </Owner>
    <StorageClass>STANDARD</StorageClass>
    <Initiated>2023-04-16T20:48:33.000Z</Initiated>
  </Upload>
</ListMultipartUploadsResult>