Container operations

StorageGRID supports a maximum of 1,000 containers per Swift account. The following Swift API operations are performed on containers.

DELETE container

This operation removes an empty container from a Swift account in a StorageGRID system.

The following request parameters are required:

The following request header is required:

A successful execution returns the following headers with an "HTTP/1.1 204 No Content" response:

GET container

This operation retrieves the object list associated with the container along with container statistics and metadata in a StorageGRID system.

The following request parameters are required:
  • Account
  • Container

The following request header is required:

The following supported request query parameters are optional:

A successful execution returns the following headers with an "HTTP/1.1 200 Success" or a "HTTP/1.1 204 No Content" response:

HEAD container

This operation retrieves container statistics and metadata from a StorageGRID system.

The following request parameters are required:

The following request header is required:

A successful execution returns the following headers with an "HTTP/1.1 204 No Content" response:

PUT container

This operation creates a container for an account in a StorageGRID system.

The following request parameters are required:

The following request header is required:

A successful execution returns the following headers with an "HTTP/1.1 201 Created" or "HTTP/1.1 202 Accepted" (if the container already exists under this account) response:

A container name must be unique in the StorageGRID namespace. If the container exists under another account, the following header is returned: "HTTP/1.1 409 Conflict."