Object Versioning and Copying

Object Versioning and Copying

Akave O3 has S3-compatible object versioning and copying enabled by default, allowing you to preserve file history, retrieve older versions, and copy data within or across buckets – all using familiar AWS CLI tools.

ℹ️
Important: Replace <YOUR_ENDPOINT_URL> in these examples with your specific endpoint URL. Find your endpoint in the Akave Environment page.
ℹ️
Note that versioning cannot be disabled on Akave O3 as data is immutably stored on the blockchain.

List Object Versions

Using aws s3api:

aws s3api list-object-versions \
  --bucket my-akave-bucket \
  --endpoint-url <YOUR_ENDPOINT_URL>

Using aws s3:

aws s3 ls s3://my-akave-bucket --recursive --human-readable \
  --endpoint-url <YOUR_ENDPOINT_URL>

Note: aws s3 will show the latest versions only. Use s3api for full version metadata.

Download a Specific Version

Using aws s3api:

aws s3api get-object \
  --bucket my-akave-bucket \
  --key myfile.txt \
  --version-id <version-id> \
  ./myfile.txt \
  --endpoint-url <YOUR_ENDPOINT_URL>

Using aws s3:

Not directly supported for specific versions. Use s3api if version targeting is required.

Delete a Specific Version

Using aws s3api:

aws s3api delete-object \
  --bucket my-akave-bucket \
  --key myfile.txt \
  --version-id <version-id> \
  --endpoint-url <YOUR_ENDPOINT_URL>

Using aws s3:

Not supported — use s3api for versioned object deletion.

Copy an Object

Within the same bucket (using s3api):

aws s3api copy-object \
  --bucket my-akave-bucket \
  --copy-source my-akave-bucket/myfile.txt \
  --key myfile-copy.txt \
  --endpoint-url <YOUR_ENDPOINT_URL>

Using aws s3:

aws s3 cp s3://my-akave-bucket/myfile.txt s3://my-akave-bucket/myfile-copy.txt \
  --endpoint-url <YOUR_ENDPOINT_URL>

Across buckets:

aws s3 cp s3://source-bucket/myfile.txt s3://destination-bucket/myfile-copy.txt \
  --endpoint-url <YOUR_ENDPOINT_URL>

Note: While aws s3api offers full control over versioning and metadata, aws s3 is easier for basic operations. Use them together for a flexible Akave O3 workflow.

Last updated on