Uploads and Multipart

Upload and copy objects, including concurrent S3 multipart uploads for large files.

Upload an object

Use PutObject for ordinary uploads. The object key is the complete path after the bucket name, and missing directory prefixes need no separate creation.

AWS CLI
aws s3 cp ./archive.tar s3://<bucket>/backups/archive.tar \
  --endpoint-url https://storage.acdn.uz \
  --profile acdn

Copy an existing object

  • CopyObject supports copies within the same storage-zone bucket.
  • The source object may be local to another storage replica; the gateway resolves it transparently.
  • The maximum CopyObject source size is 5 GiB. Multipart copy with UploadPartCopy is not supported.
  • Metadata can be copied or replaced with the standard x-amz-metadata-directive header.

S3 multipart upload

Use multipart upload for large or retry-sensitive objects. Standard S3 clients handle the lifecycle without ACDN-specific requests.

  • Supported operations are CreateMultipartUpload, UploadPart, CompleteMultipartUpload, and AbortMultipartUpload.
  • Parts may be uploaded concurrently, retried, or replaced by uploading the same part number again.
  • Every part except the final part must be at least 5 MiB. One object may contain at most 10,000 parts.
  • CompleteMultipartUpload requires ascending part numbers and the exact ETag returned for every uploaded part.
  • AbortMultipartUpload removes the staged parts. Incomplete uploads are not visible as objects.
  • The completed multipart ETag is compound and must not be treated as a whole-file MD5 checksum.
  • S3 multipart upload is not an HTML multipart/form-data request.

Multipart with Laravel Flysystem

Flysystem and the AWS SDK automatically switch to multipart above their configured threshold. writeStream() keeps the application memory footprint bounded.

Laravel Flysystem
Storage::disk('acdn_s3')->writeStream('backups/archive.tar', $stream, [
    'mimetype' => 'application/octet-stream',
    'part_size' => 64 * 1024 * 1024,
]);