ListMultipartUploads

This action lists in-progress multipart uploads.

An in-progress multipart upload is a multipart upload that has been initiated using the Initiate Multipart Upload request (see CreateMultipartUpload), but not completed or aborted.

This action returns all multipart uploads in the response.

You must have Upload ACL to be able to call this action.

The following operations are related to ListMultipartUploads:

Request Syntax

1GET /?uploads HTTP/1.1
2Host: <BUCKET>.s3.tebi.io

  • <BUCKET>: Bucket name to which the upload was taking place. Required.

The request does not have a request body.

Response Syntax

 1HTTP/1.1 200
 2Content-Type: application/xml
 3Content-Length: <CONTENT_LENGTH>
 4
 5<?xml version="1.0" encoding="UTF-8"?>
 6<ListMultipartUploadsResult>
 7    <Bucket>string</Bucket>
 8    <KeyMarker>string</KeyMarker>
 9    <UploadIdMarker>string</UploadIdMarker>
10    <NextKeyMarker>string</NextKeyMarker>
11    <Prefix>string</Prefix>
12    <Delimiter>string</Delimiter>
13    <NextUploadIdMarker>string</NextUploadIdMarker>
14    <MaxUploads>integer</MaxUploads>
15    <IsTruncated>boolean</IsTruncated>
16    <Upload>
17        <Initiated>timestamp</Initiated>
18        <Initiator>
19            <DisplayName>string</DisplayName>
20            <ID>string</ID>
21        </Initiator>
22        <Key>string</Key>
23        <Owner>
24            <DisplayName>string</DisplayName>
25            <ID>string</ID>
26        </Owner>
27        <StorageClass>string</StorageClass>
28        <UploadId>string</UploadId>
29    </Upload>
30    ...
31</ListMultipartUploadsResult>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in XML format by the service:

  • ListMultipartUploadsResult: Root level tag for the ListMultipartUploadsResult parameters.

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

  • IsTruncated: Always false.

  • KeyMarker: Not used; always empty.

  • MaxUploads: Not used; always 1000.

  • NextKeyMarker: Not used; always empty.

  • NextUploadIdMarker: Not used; always empty.

  • Prefix: Not used; always empty.

  • Upload: Container for elements related to a particular multipart upload. A response can contain zero or more Upload elements.

  • UploadIdMarker: Not used; always empty.

See Also

Refer here for more information.