Swift list a container’s objects

Edit online

To list the objects within a container, make a GET request with the API version, account, and the name of the container. You can specify query parameters to filter the full list, or leave out the parameters to return a list of the first 10,000 object names stored in the container.

Syntax

GET /_AP_VERSION_/_TENANT_:_CONTAINER_ HTTP/1.1
Host: FULLY_QUALIFIED_DOMAIN_NAME
X-Auth-Token: _AUTH_TOKEN_

Request Parameters

format
Description: Limits the number of results to the specified value.
Type: Integer
Valid Values: json or xml
Required: No
prefix
Description: Limits the result set to objects beginning with the specified prefix.
Type: String
Valid Values: N/A
Required: No

marker

Description: Returns a list of results greater than the marker value.
Type: String
Valid Values: N/A
Required: No

limit

Description: Limits the number of results to the specified value.
Type: Integer
Valid Values: 0 - 10,000
Required: No

delimiter

Description: The delimiter between the prefix and the rest of the object name.
Type: String
Valid Values: N/A
Required: No

path

Description: The pseudo-hierarchical path of the objects.
Type: String
Valid Values: N/A
Required: No

Response Entities

container

Description: The container.
Type: Container

object

Description: An object within the container.
Type: Container

name

Description: The name of an object within the container.
Type: String

hash

Description: A hash code of the object’s contents.
Type: String

last_modified

Description: The last time the object’s contents were modified.
Type: Date

content_type

Description: The type of content within the object.
Type: String