S3 Storage Quick Start

Connect AWS CLI or Laravel Flysystem with SigV4, path-style addressing, and your storage-zone credentials.

Connect with AWS CLI

Each storage zone is an isolated bucket with its own region and credentials. ACDN implements the S3 operations listed below through AWS Signature Version 4 and path-style addressing.

Open API & S3 Access for your storage zone and copy its endpoint, bucket name, region, access key ID, and secret. The dashboard values are authoritative for that zone.

  1. Use the endpoint exactly as displayed in the dashboard.
  2. Use the storage-zone name as the bucket.
  3. Use the zone region for SigV4 signing.
  4. Enable path-style addressing; virtual-hosted bucket URLs are not supported.
  5. You can keep multiple keys active during rotation and assign read, write, and delete permissions independently.
AWS CLI
aws configure set aws_access_key_id <access-key-id> --profile acdn
aws configure set aws_secret_access_key <secret-access-key> --profile acdn
aws configure set region <storage-region> --profile acdn

aws s3 ls s3://<bucket> \
  --endpoint-url https://storage.acdn.uz \
  --profile acdn

Laravel and Flysystem

Configure a normal Laravel S3 disk with the ACDN endpoint and path-style mode. No gateway-specific adapter is required.

config/filesystems.php
'acdn_s3' => [
    'driver' => 's3',
    'key' => env('ACDN_S3_ACCESS_KEY_ID'),
    'secret' => env('ACDN_S3_SECRET_ACCESS_KEY'),
    'region' => env('ACDN_S3_REGION'),
    'bucket' => env('ACDN_S3_BUCKET'),
    'endpoint' => env('ACDN_S3_ENDPOINT', 'https://storage.acdn.uz'),
    'use_path_style_endpoint' => true,
],

Supported S3 operations

Compatibility is operation-based. Use this matrix instead of assuming every AWS S3 bucket-management feature is available.

Service and bucket reads Supported

The read permission covers ListBuckets, HeadBucket, and ListObjectsV2.

Object reads Supported

The read permission covers GetObject, HeadObject, byte ranges, conditional reads, and GetObjectAcl.

Object writes Supported

The write permission covers PutObject and presigned writes. Same-bucket CopyObject up to 5 GiB requires both read and write.

Object deletion Supported

The delete permission covers DeleteObject.

Multipart uploads Supported

The write permission covers CreateMultipartUpload, UploadPart, CompleteMultipartUpload, and AbortMultipartUpload.

Compatibility boundaries

  • Bucket creation, deletion, policies, ACL mutation, versioning, lifecycle, tagging, and website configuration are not implemented.
  • DeleteObjects batch deletion and UploadPartCopy are not implemented.
  • CopyObject works only within the same bucket and supports source objects up to 5 GiB.
  • Every S3 credential is bound to one storage-zone bucket; a zone may have multiple credentials, but ListBuckets does not enumerate unrelated buckets.