v1

latestOpenAPI 3.0.0Creative Commons Attribution 3.02026-07-138134216.7 KB
folders

Retrieves a list of folders matching the criteria. Only applicable to buckets with hierarchical namespace enabled.

get/b/{bucket}/folders

Path parameters

bucketstring required

Name of the bucket in which to look for folders.

Query parameters

delimiterstring

Returns results in a directory-like mode. The only supported value is '/'. If set, items will only contain folders that either exactly match the prefix, or are one level below the prefix.

endOffsetstring

Filter results to folders whose names are lexicographically before endOffset. If startOffset is also set, the folders listed will have names between startOffset (inclusive) and endOffset (exclusive).

pageSizeinteger

Maximum number of items to return in a single page of responses.

pageTokenstring

A previously-returned page token representing part of the larger set of results to view.

prefixstring

Filter results to folders whose paths begin with this prefix. If set, the value must either be an empty string or end with a '/'.

startOffsetstring

Filter results to folders whose names are lexicographically equal to or after startOffset. If endOffset is also set, the folders listed will have names between startOffset (inclusive) and endOffset (exclusive).

Response

Successful response