• Object Storage Service

obs
  1. Help Center
  2. Object Storage Service
  3. API Reference (OBS)
  4. Operations on Buckets
  5. List Multipart Uploads
  6. Responses

Responses

Syntax

HTTP/1.1 status_code 
 Server: OBS
 x-amz-request-id: request id 
 x-reserved: amazon, aws and amazon web services are trademarks or registered trademarks of Amazon Technologies, Inc 
 x-amz-id-2: id2 
 Content-Length: length 
 Date: date 
 Connection: connect state

 <?xml version="1.0" encoding="UTF-8" standalone="yes"?> 
 <ListMultipartUploadsResult xmlns="http://obs.example.com/doc/2015-06-30/"> 
 <Bucket>bucket</Bucket> 
 <KeyMarker></KeyMarker> 
 <UploadIdMarker></UploadIdMarker> 
 <NextKeyMarker>nextMarker</NextKeyMarker> 
 <NextUploadIdMarker>idMarker</NextUploadIdMarker> 
 <MaxUploads>maxUploads</MaxUploads> 
 <IsTruncated>true</IsTruncated> 
 <Upload> 
 <Key>key</Key> 
 <UploadId>uploadID</UploadId> 
 <Initiator> 
 <ID>id</ID> 
 <DisplayName>name</DisplayName> 
 </Initiator> 
 <Owner> 
 <ID>ownerID</ID> 
 <DisplayName>OwnerDisplayName</DisplayName> 
 </Owner> 
 <StorageClass>STANDARD</StorageClass> 
 <Initiated>initiatedDate</Initiated>  
 </Upload> 
 </ListMultipartUploadsResult>

Response Headers

This response uses common headers. For details about common response headers, see section Common Response Headers.

Response Elements

This response contains elements to provide details about the listed multipart uploads. Table 1 describes the elements.

Table 1 Response elements

Element

Description

Remarks

ListMultipartUploads Result

Container for the response

Type: Container

Children: BucketKeyMarkerUploadIdMarkerNextKeyMarkerNextUploadIdMarkerDelimiterPrefixMaxUploadsIsTruncatedUpload, and CommonPrefixes

Ancestor: None

Mandatory

Bucket

Name of the bucket to which the multipart upload was initiated

Type: String

Ancestor: ListMultipartUploadsResult

Mandatory

KeyMarker

Object keys at or after which the multipart upload listing begins

Type: String

Ancestor: ListMultipartUploadsResult

Mandatory

UploadIdMarker

Upload ID after which the multipart upload listing begins

Type: String

Ancestor: ListMultipartUploadsResult

Mandatory

NextKeyMarker

Value of KeyMarker in a subsequent request after a multipart upload list is truncated

Type: String

Ancestor: ListMultipartUploadsResult

Mandatory

NextUploadIdMarker

Value of UploadMarker in a subsequent request after a multipart upload list is truncated

Type: String

Ancestor: ListMultipartUploadsResult

Mandatory

MaxUploads

Maximum of multipart uploads to be returned in the response

Type: Integer

Ancestor: ListMultipartUploadsResult

Mandatory

IsTruncated

Indicates whether the returned list of multipart uploads is truncated. true indicates that the list was truncated and false indicates that the list was not truncated.

Type: Boolean

Ancestor: ListMultipartUploadsResult

Mandatory

Upload

Container for elements related to a specific multipart upload

Type: Container

Children: KeyUploadIdInitiatorOwnerStorageClassInitiated

Ancestor: ListMultipartUploadsResult

Mandatory

Key

Key of the object for which the multipart upload was initiated

Type: String

Ancestor: Upload

Mandatory

UploadId

ID of the multipart upload

Type: String

Ancestor: Upload

Mandatory

Initiator

Container element that identifies who initiated the multipart upload

Children: IDDisplayName

Type: Container

Ancestor: Upload

Mandatory

ID

DomainId of the user.

Type: String

Ancestor: InitiatorOwner

Mandatory

DisplayName

Initiator name

Type: String

Ancestor: InitiatorOwner

Mandatory

Owner

Container element that identifies the object owner. This element is the same as Initiator and compatible with Amazon S3. In S3, if a multipart upload is initiated by an IAM user, Initiator may differ from Owner.

Type: Container

Children: IDDisplayName

Ancestor: Upload

Mandatory

StorageClass

Type of storage that will be used for storing objects after the multipart upload is complete.

Type: Enumeration

Ancestor: Upload

Mandatory

Initiated

Date and time at which the multipart upload was initiated

Type: Date

Ancestor: Upload

Mandatory

ListMultipartUploadsResult.Prefix

Contains the prefix specified in the request.

Type: String

Ancestor: ListMultipartUploadsResult

Mandatory

Delimiter

Contains the delimiter specified in the request.

Type: String

Ancestor: ListMultipartUploadsResult

Mandatory

CommonPrefixes

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

Type: Container

Ancestor: ListMultipartUploadsResult

Mandatory

CommonPrefixes. Prefix

Prefix contained in a CommonPrefix element

Type: String

Ancestor: CommonPrefixes

Mandatory

Error Responses

  1. If an AK or signature is invalid, OBS returns status code 403 Forbidden and error code AccessDenied.
  2. If the requested bucket does not exist, OBS returns status code 404 Not Found and error code NoSuchBucket.
  3. If the requester does not have READ permission for the requested bucket, OBS returns status code 403 Forbidden and error code AccessDenied.
  4. If the value of maxUploads is a non-integer or smaller than 0, OBS returns status code 400 Bad Request.

For details about other error responses, see Table 1.