Request

GET

/v1/{account}/{container}{?limit,marker,end_marker,prefix,format,delimiter,path}

Shows metadata of a specified container and lists objects, sorted by name in ascending order, in the container.

{account}

String

(Required)

A unique account name. In the current version, it indicates a unique ID for the account.

{container}

String

(Required)

A unique container name.

For details about container naming rules, see Naming Rules.

X-Auth-Token

String

(Required)

Authentication token.

Accept

String

(Optional)

Similar to the format query parameter, set this header to application/json, application/xml, or text/xml.

limit

Int

(Optional)

Limits the number of objects in a query result.

Value range: 0 to 10000

Default value: 10000

If this parameter is set to a value larger than 10000, an error is reported.

marker

String

(Optional)

Returns object names that are greater than the specified marker.

end_marker

String

(Optional)

Returns object names that are smaller than the specified marker.

format

String

(Optional)

Sets the format of the returned object list. The valid values are plain (default), json, and xml. Its function is the same as Accept.

prefix

String

(Optional)

Returns objects that have the specified prefix.

delimiter

Char

(Optional)

Returns the object names that are nested in the container.

path

String

(Optional)

Returns the object names that are nested in the specified path. Equivalent to setting delimiter to / and prefix to the path with a slash (/) at the end.