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