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 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.
Storage::disk('acdn_s3')->writeStream('backups/archive.tar', $stream, [
'mimetype' => 'application/octet-stream',
'part_size' => 64 * 1024 * 1024,
]);