Container operations

The following Swift API operations are performed on containers.

The StorageGRID Webscale system supports a maximum of 1000 containers per Swift account.
Operation Implementation
DELETE container

Removes an empty container from a Swift account in a StorageGRID Webscale 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

Retrieves the object list associated with the container along with container statistics and metadata in a StorageGRID Webscale 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

When this operation is set in Keystone enabled configurations, the following headers are returned to admin users:

  • X-Container-Read
  • X-Container-Write
Note: Keystone is disabled by default. To enable Keystone, contact your NetApp representative.
HEAD container

Retrieves container statistics and metadata from a StorageGRID Webscale 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

When this operation is set in Keystone enabled configurations, the following headers are returned to admin users:

  • X-Container-Read
  • X-Container-Write
Note: Keystone is disabled by default. To enable Keystone, contact your NetApp representative.
POST container

Creates, modifies, or deletes the ACL metadata for an existing container by an admin user in a Keystone configured StorageGRID Webscale system.

Note: This operation is supported only for Swift Keystone accounts. Keystone is disabled by default. To enable Keystone, contact your NetApp representative.

When Keystone is disabled (default), a status of Not Implemented is returned for this operation.

The following request parameters are required:

  • Account
  • Container

The following request header is required:

  • X-Auth-Token

The following request headers are optional:

  • X-Container-Read
  • X-Container-Write
  • X-Remove-Container-Read
  • X-Remove-Container-Write
Note: No other metadata operations are supported and will result in the operation being ignored.

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

  • Content-Length
  • Date
  • X-Timestamp
  • X-Trans-Id
PUT container

Creates a container for an account in a StorageGRID Webscale 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 Webscale namespace. If the container exists under another account, the following header is returned: "HTTP/1.1 409 Conflict."

The following optional headers are supported only for admin users in Keystone enabled configurations:

  • X-Container-Read
  • X-Container-Write
  • X-Remove-Container-Read
  • X-Remove-Container-Write
Note: This operation is supported only for Swift Keystone accounts. Keystone is disabled by default. To enable Keystone, contact your NetApp representative.