Skip to main content

Container operations

Contributors ssantho3 netapp-lhalbert

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:

  • Account

  • Container

The following request header is required:

  • X-Auth-Token

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

  • Content-Length

  • Content-Type

  • Date

  • X-Trans-Id

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:

  • X-Auth-Token

The following supported request query parameters are optional:

  • Delimiter

  • End_marker

  • Format

  • Limit

  • Marker

  • Path

  • Prefix

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

  • Accept-Ranges

  • Content-Length

  • Content-Type

  • Date

  • X-Container-Bytes-Used

  • X-Container-Object-Count

  • X-Timestamp

  • X-Trans-Id

HEAD container

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

The following request parameters are required:

  • Account

  • Container

The following request header is required:

  • X-Auth-Token

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

  • Accept-Ranges

  • Content-Length

  • Date

  • X-Container-Bytes-Used

  • X-Container-Object-Count

  • X-Timestamp

  • X-Trans-Id

PUT container

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

The following request parameters are required:

  • Account

  • Container

The following request header is required:

  • X-Auth-Token

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:

  • Content-Length

  • Date

  • X-Timestamp

  • X-Trans-Id

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."

Related information

Monitor and audit operations