• Object Storage Service

obs
  1. Help Center
  2. Object Storage Service
  3. API Reference (OBS)
  4. Operations on Buckets
  5. GET Bucket Object versions
  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: id 
 Content-Type: type 
 Date: date 
 Content-Length: length 

 <?xml version="1.0" encoding="UTF-8" standalone="yes"?> 
 <ListVersionsResult xmlns="http://obs.example.com/doc/2015-06-30/"> 
 <Name>bucket</Name> 
 <Prefix/> 
 <KeyMarker/> 
 <VersionIdMarker/> 
 <NextKeyMarker>nextKeyMarker</NextKeyMarker> 
 <NextVersionIdMarker>nextVersionIdMarker</NextVersionIdMarker> 
 <MaxKeys>maxKeys</MaxKeys> 
 <IsTruncated>boolean</IsTruncated> 
 <Version> 
 <Key>object</Key> 
 <VersionId>versionId</VersionId> 
 <IsLatest>boolean</IsLatest> 
 <LastModified>date</LastModified> 
 <ETag>String</ETag> 
 <Size>size</Size> 
 <Owner> 
 <ID>ownerID</ID> 
 <DisplayName>name</DisplayName> 
 </Owner> 
 <StorageClass>storageClass</StorageClass> 
 </Version> 
 <DeleteMarker> 
 <Key>object</Key> 
 <VersionId>versionId</VersionId> 
 <IsLatest>boolean</IsLatest> 
 <LastModified>date</LastModified> 
 <Owner> 
 <ID>ownerID</ID> 
 <DisplayName>name</DisplayName> 
 </Owner> 
 </DeleteMarker> 
 </ListVersionsResult>

Response Headers

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

In addition to common headers, when CORS is configured for buckets, you can use the response headers in Table 1.

Table 1 Appended response headers

Header

Description

Access-Control-Allow-Origin

If Origin in the request meets the CORS configuration requirements, Origin is included in the response.

Type: String

Access-Control-Allow-Headers

If headers in the request meet the CORS configuration requirements, headers are included in the response.

Type: String

Access-Control-Max-Age

Indicates MaxAgeSeconds in the CORS configuration of a server.

Type: Integer

Access-Control-Allow-Methods

If Access-Control-Request-Method in the request meets the CORS configuration requirements, methods in the rule are included in the response.

Type: String

Valid values: GETPUTHEADPOST, and DELETE

Access-Control-Expose-Headers

Indicates ExposeHeader in the CORS configuration of a server.

Type: String

Response Elements

This response contains elements to specify the objects (including objects with multiple version IDs) in a bucket. Table 2 describes the elements.

Table 2 Response elements

Element

Description

ListVersionsResult

Indicates the container for the list of objects (including objects with multiple version IDs).

Type: Container

Name

Indicates the bucket name.

Type: String

Ancestor: ListVersionsResult

Prefix

Indicates the prefix of an object key. Only objects whose keys have this prefix are listed.

Type: String

Ancestor: ListVersionsResult

KeyMarker

Indicates the object key to start with when listing objects.

Type: String

Ancestor: ListVersionsResult

VersionIdMarker

Indicates the object version ID to start with when listing objects.

Type: String

Ancestor: ListVersionsResult

NextKeyMarker

Indicates the key marker for the last returned object in the list. NextKeyMarker is returned when not all the objects are listed. You can set the KeyMarker value to list the remaining objects in follow-up requests.

Type: String

Ancestor: ListVersionsResult

NextVersionIdMarker

Indicates the version ID marker for the last returned object in the list. NextVersionIdMarker is returned when not all the objects are listed. You can set the VersionIdMarker value to list the remaining objects in follow-up requests.

Type: String

Ancestor: ListVersionsResult

MaxKeys

Indicates the maximum objects returned.

Type: String

Ancestor: ListVersionsResult

IsTruncated

Determines whether the returned list of objects is truncated. true indicates that the result is incomplete while false indicates that the result is complete.

Type: Boolean

Ancestor: ListVersionsResult

Version

Indicates the container for version information.

Type: Container

Ancestor: ListVersionsResult

DeleteMarker

Indicates the container for objects with deletion marks.

Type: Container

Ancestor: ListVersionsResult

key

Name of an object

Type: String

Ancestor: ListVersionsResult.Version | ListVersionsResult.DeleteMarker

VersionId

Indicates the object version ID.

Type: String

Ancestor: ListVersionsResult.Version | ListVersionsResult.DeleteMarker

IsLatest

Specifies whether the object is or is not of the latest version. If the element is true, the object is of the latest version.

Type: Boolean

Ancestor: ListVersionsResult.Version | ListVersionsResult.DeleteMarker

LastModified

Indicates the date and time when the last modification was made to an object.

Type: Date

Ancestor: ListVersionsResult.Version | ListVersionsResult.DeleteMarker

ETag

MD5 value of an object

Type: String

Ancestor: ListVersionsResult.Version

Size

Number of bytes of an object

Type: String

Ancestor: ListVersionsResult.Version

Owner

User information, including the DomainId and name

Type: Container

Ancestor: ListVersionsResult.Version | ListVersionsResult.DeleteMarker

ID

DomainId of an object owner

Type: String

Ancestor: ListVersionsResult.Version.Owner | ListVersionsResult.DeleteMarker.Owner

DisplayName

Name of an object owner

Type: String

Ancestor: ListVersionsResult.Version.Owner | ListVersionsResult.Version.Owner

StorageClass

Storage type of an object

Type: Enumeration

Ancestor: ListVersionsResult.Version

CommonPrefixes

Grouping information. If you specify a delimiter in the request, the response contains grouping information in CommonPrefixes.

Type: Container

Ancestor: ListVersionsResult

Prefix

Indicates a different prefix in the grouping information in CommonPrefixes.

Type: String

Ancestor: ListVersionsResult.CommonPrefixes

Error Responses

No special error responses are returned. For details about error responses, see Table 1.