• Object Storage Service

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

Responses

Syntax

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

 <?xml version="1.0" encoding="UTF-8" standalone="yes"?> 
 <ListPartsResult xmlns="http://obs.example.com/doc/2015-06-30/"> 
 <Bucket>BucketName</Bucket> 
 <Key>ObjectName </Key> 
 <UploadId>uploadid</UploadId> 
 <Initiator> 
 <ID>initiatorid</ID>  
 <DisplayName>displayname</DisplayName> 
 </Initiator> 
 <Owner> 
 <ID>ownerid</ID> 
 <DisplayName>ownername</DisplayName> 
 </Owner> 
 <StorageClass>STANDARD</StorageClass> 
 <PartNumberMarker>partNmebermarker</PartNumberMarker> 
 <NextPartNumberMarker>nextpartnumbermarker</NextPartNumberMarker> 
 <MaxParts>2</MaxParts> 
 <IsTruncated>true</IsTruncated> 
 <Part> 
 <PartNumber>partnumber</PartNumber> 
 <LastModified>modifieddate</LastModified> 
 <ETag>etag</ETag> 
 <Size>etag</Size> 
 </Part> 
 ..  
 </ListPartsResult>

Response Headers

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

Response Elements

This response uses elements to provide details about the listed parts. Table 1 describes the elements.

Table 1 Response elements

Element

Description

ListPartsResult

Container for the response

Type: Container

Children: BucketKeyUploadIdPartNumberMarkerNextPartNumberMarkerMaxPartsIsTruncatedPart

Ancestor: None

Bucket

Name of the bucket to which the multipart upload was initiated

Type: String

Ancestor: ListPartsResult

Key

Key of the object for which the multipart upload was initiated

Type: String

Ancestor: ListPartsResult

UploadId

ID that identifies the multipart upload whose parts are listed

Type: String

Ancestor: ListPartsResult

Initiator

Container element that identifies who initiated the multipart upload

Type: Container

Children: IDDisplayName

Ancestor: ListPartsResult

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.

Children: IDDisplayName

Ancestor: ListPartsResult

ID

DomainId of initiator or owner.

Type: String

Ancestor: Initiator or Owner

DisplayName

Initiator name

Type: String

Ancestor: Initiator or Owner

StorageClass

Storage class.

Type: Enumeration

Valid values: STANDARD | STANDARD_IA |GLACIER

Ancestor: ListPartsResult

PartNumberMarker

Part number after which the part listing begins

Type: Integer

Ancestor: ListPartsResult

NextPartNumber Marker

Value of PartNumberMarker in a subsequent request after a part list is truncated.

Type: Integer

Ancestor: ListPartsResult

MaxParts

Maximum number of parts that are returned

Type: Integer

Ancestor: ListPartsResult

IsTruncated

Indicates whether the returned part list is truncated. true indicates that the list was truncated and false indicates that the list was not truncated.

Type: Boolean

Ancestor: ListPartsResult

Part

Container for elements related to a particular part

Type: String

Children: PartNumberLastModifiedETagSize

Ancestor: ListPartsResult

PartNumber

Number that identifies a part

Type: Integer

Ancestor: ListPartsResult.Part

LastModified

Date and time at which a part was uploaded

Type: Date

Ancestor: ListPartsResult.Part

ETag

ETag of an uploaded part.

Type: String

Ancestor: ListPartsResult.Part

Size

Size of an uploaded part

Type: Integer

Ancestor: ListPartsResult.Part

Error Responses

  • If an AccessKey or signature is invalid, OBS returns status code 403 Forbidden and error code AccessDenied.
  • If the requested bucket does not exist, OBS returns status code 404 Not Found and error code NoSuchBucket.
  • If the requested multipart upload does not exist, OBS returns status code 404 Not Found and error code NoSuchUpload.
  • If the requester does not have READ permission for the requested bucket, OBS returns status code 403 Forbidden and error code AccessDenied.

For details about other error responses, see Table 1.