GET /?query={expression}&attributes={name, ...}&sorted={key}&include-older-versions={true|false}
Executes a bucket search and returns list of objects, and their system and user metadata values, that match the selection conditions in the search query expression.
The objects returned can be restricted using the max-keys parameter. Where a subset of the search matches are returned, subsequent pages can be retrieved by using the marker from the previous search; the objects returned will start with the key after the marker.
Query Parameters
query (required) is an expression takes the form: [(]{condition1}[%20[and/or]%20{condition2}][)][%20[and/or]%20...]
where:
condition is a metadata keyname filter in the form: {selector} {operator} {argument}
, for example "LastModified>2015-01-01T00:00:00Z"
in which:
selector
is a searchable keyname associated with the bucket
operator
is one of: ==, >, =,
argument
is a value against which the selector is tested. The form of the argument must match the datatype of the key being indexed, which is one of: string, integer, datetime, decimal
Other Parameters
attributes
(optional) is a list one or more metadata names that are not being indexed, but which can be listed in the query results. For example: "&attributes=ContentType,Retention"
sorted
(optional) is the name of one key that appears in the query expression that becomes the sort key for the query results. If this optional parameter is absent, the sort order is the first keyname that appears in the expression.
include-older-versions
(optional) is a boolean that when set to true causes both current and non-current versions of the keys to be listed, and when set to false causes only the current versions of keys to be listed. The default is false.
max-keys
(optional) specifies the number of keys returned in the response body. Allows you to return fewer keys that the default.
marker
(optional) specifies the key to start with which will be the one after the marker. When no more pages exist, a marker will not be returned and NO MORE PAGES will be returned