Request Parameters for Listing Object Versions

options

const obs_options *

Yes

The context of the requested bucket. Refer to Configuring option (SDK for C) to set the AK, SK, endpoint, bucket, timeout, and temporary credentials through obs_options.

prefix

char *

No

Name prefix that the objects to be listed must contain

key_marker

char *

No

Object name to start with when listing object versions in a bucket. All object versions following the specified value are listed in lexicographical order by object name.

delimiter

char *

No

The character used to group object names. If the object name contains the value specified by the delimiter parameter, the string from the first character to the first delimiter in the object name (excluding the prefix if prefix is specified) is grouped into one common_prefixes to be returned.

version_id_marker

char *

No

Version ID to start with when listing objects in a bucket. All objects are listed in alphabetical order by object name and version ID. This parameter must be used together with key_marker.

maxkeys

int

Yes

Maximum number of objects listed in the response body. The value ranges from 1 to 1000. If the value exceeds 1000, only 1,000 objects are returned.

handler

obs_list_versions_handler *

Yes

A callback structure where all members are pointers to callback functions, used to set the callback functions that handle response data. You can set a callback function to copy the response data from the server to your custom callback_data.

callback_data

void *

No

Custom callback data.