Object Storage APIs (OBS) update : A new operation is now available


Flexible Engine
Release Notes

July, 2022


With this new update, users can improve the list of objects requested in a bucket. 

How to use it 

  • You must have permission to read the bucket. 
  • If the bucket name is specified in a request URI and list-type is explicitly set to 2, i.e. GET /?list-type is set to 2, descriptions of some or all objects in the bucket are returned in the V2 API format.  
  • Information about up to 1000 objects can be returned at a time. If one or more of the prefix, encoding-type, max-keys, delimiter, fetch-owner, start-after, and continuation-token parameters are also specified, objects are returned based on the syntax described in the Query Parameters section below : 
Parameter Description Mandatory
List-type It can be set to 2 only, indicating that the ListObjectV2 API is used. Type: number Yes
Prefix Lists objects that begin with the specified prefix. Type: string No
Start-after Specifies a marker when listing objects in a bucket. With a marker configured, objects after this marker will be returned in alphabetical order. Type: string No
Max-keys Sets the maximum number of objects returned (in alphabetical order) in the response. The value ranges from 1 to 1,000. If there are over 1,000 objects, only 1,000 objects are returned by default. Type: integer No