List Object Versions

GET {{baseUrl}}/n/:namespaceName/b/:bucketName/objectversions?limit=154

Lists the object versions in a bucket.

ListObjectVersions returns an ObjectVersionCollection containing at most 1000 object versions. To paginate through more object versions, use the returned opc-next-page value with the page request parameter.

To use this and other API operations, you must be authorized in an IAM policy. If you are not authorized, talk to an administrator. If you are an administrator who needs to write policies to give users access, see Getting Started with Policies.

Request Params

KeyDatatypeRequiredDescription
prefixstringThe string to use for matching against the start of object names in a list query.
startstringObject names returned by a list query must be greater or equal to this parameter.
endstringObject names returned by a list query must be strictly less than this parameter.
limitnumberFor list pagination. The maximum number of results per page, or items to return in a paginated
"List" call. For important details about how pagination works, see
List Pagination.
delimiterstringWhen this parameter is set, only objects whose names do not contain the delimiter character
(after an optionally specified prefix) are returned in the objects key of the response body.
Scanned objects whose names contain the delimiter have the part of their name up to the first
occurrence of the delimiter (including the optional prefix) returned as a set of prefixes.
Note that only '/' is a supported delimiter character at this time.
fieldsstringObject summary by default includes only the 'name' field. Use this parameter to also
include 'size' (object size in bytes), 'etag', 'md5', 'timeCreated' (object creation date and time),
'timeModified' (object modification date and time), 'storageTier' and 'archivalState' fields.
Specify the value of this parameter as a comma-separated, case-insensitive list of those field names.
For example 'name,etag,timeCreated,md5,timeModified,storageTier,archivalState'.
startAfterstringObject names returned by a list query must be greater than this parameter.
pagestringFor list pagination. The value of the opc-next-page response header from the previous "List" call. For important
details about how pagination works, see List Pagination.

HEADERS

KeyDatatypeRequiredDescription
opc-client-request-idstringThe client request ID for tracing.
Acceptstring

RESPONSES

status: OK

{"items":[{"isDeleteMarker":false,"name":"ex mollit ea ","timeModified":"1982-10-10T05:57:35.428Z","versionId":"dolor","archivalState":"Archived","etag":"magna adipisicing velit ut laboris","md5":"laborum","size":91913270,"storageTier":"InfrequentAccess","timeCreated":"2001-07-05T13:41:27.691Z"},{"isDeleteMarker":false,"name":"q","timeModified":"2007-02-16T09:11:49.081Z","versionId":"nisi do voluptate eiusmod amet","archivalState":"Archived","etag":"magna","md5":"nulla eiusmod","size":-38160171,"storageTier":"Archive","timeCreated":"1971-02-03T08:12:01.556Z"}],"prefixes":["officia amet tempor","non consectetur"]}