Help Center> Object Storage Service> SDK Reference> Python> Data Types> Request Parameters of Listing Versioned Objects in a Bucket
View PDF

Request Parameters of Listing Versioned Objects in a Bucket

Namespace

obs.Versions

Parameter Description

Field

Type

Optional or Mandatory

Description

prefix

str

Optional

Name prefix that the objects to be listed must contain

key_marker

str

Optional

Object name to start with when listing versioned objects in a bucket. All versioned objects following this parameter are listed in the lexicographical order.

max_keys

int

or

str

Optional

Maximum number of objects returned. The value ranges from 1 to 1000. If the value is not in this range, 1000 is returned by default.

delimiter

str

Optional

Character used to group object names. If the object name contains the delimiter parameter, the character string from the first character to the first delimiter in the object name is grouped under the single result element commonPrefix. (If a prefix is specified in the request, the prefix must be removed from the object name.)

version_id_marker

str

Optional

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

If the value of version_id_marker is not a version ID specified by key_marker, version_id_marker does not take effect.
Parent topic: Data Types