Multipart MIME POST

Content Gateway allows client applications to use the HTTP multipart MIME POST to upload multiple files in one operation. Gateway converts these multiple parts into individual POST operations to Swarm. While Gateway always returns an HTTP 202 response code, the body of the response contains the results of the individual POST operations. The Content Portal uses this mechanism for the upload page.

While processing this type of request, the individual files are extracted from the original POST request and spooled to the Gateway server's local file system before transmitting them to Swarm. The spool directory is specified with the multipartSpoolDir setting and is allowed to fill the file system up to a maximum percentage defined with the multipartUsageAllowed setting.

Important

Verify the file system has sufficient disk space available to handle the incoming requests.

The multipart MIME POST request is the only type of request that uses a local disk spool on the Gateway. Requests such as SCSP single-object writes, S3 multipart uploads, and SCSP https://perifery.atlassian.net/wiki/spaces/public/pages/2443822209 are all streamed directly to Swarm.