Container operations

StorageGRID Webscale 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 Webscale 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 Webscale 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:

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

Note: Keystone is disabled by default. To enable Keystone, contact your NetApp representative.

HEAD container

This operation retrieves container statistics and metadata from a StorageGRID Webscale 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:

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

Note: Keystone is disabled by default. To enable Keystone, contact your NetApp representative.

POST container

This operation 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:

The following request header is required:

The following request headers are optional:

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:

PUT container

This operation creates a container for an account in a StorageGRID Webscale 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 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:

Note: These optional headers are supported only for Swift Keystone accounts. Keystone is disabled by default. To enable Keystone, contact your NetApp representative.