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.