Create, List, Empty, and Delete Buckets

Akave O3 is fully compatible with AWS CLI tooling. You can use both aws s3api and higher-level aws s3 commands to interact with decentralized buckets and objects.

Create a Bucket

Using aws s3api:

aws s3api create-bucket \
  --bucket my-akave-bucket \
  --endpoint-url <YOUR_ENDPOINT_URL>

Using aws s3:

aws s3 mb s3://my-akave-bucket \
  --endpoint-url <YOUR_ENDPOINT_URL>

List Buckets

Using aws s3api:

aws s3api list-buckets \
  --endpoint-url <YOUR_ENDPOINT_URL>

Using aws s3:

aws s3 ls \
  --endpoint-url <YOUR_ENDPOINT_URL>

Empty a Bucket

Because Akave O3 has versioning always enabled, you must delete every object version individually before a bucket can be deleted. Use the following script to remove all versions:

aws s3api list-object-versions \
  --bucket my-akave-bucket \
  --endpoint-url <YOUR_ENDPOINT_URL> \
  --output json | \
jq -c '(.Versions // []) + (.DeleteMarkers // []) | .[] | {Key, VersionId}' | while read -r obj; do
  KEY=$(echo "$obj" | jq -r '.Key')
  VERSION_ID=$(echo "$obj" | jq -r '.VersionId')
  aws s3api delete-object \
    --bucket my-akave-bucket \
    --key "$KEY" \
    --version-id "$VERSION_ID" \
    --endpoint-url <YOUR_ENDPOINT_URL>
done

This script requires jq to be installed. For more information on installing jq, see the jq documentation.

Delete a Bucket

Using aws s3api:

aws s3api delete-bucket \
  --bucket my-akave-bucket \
  --endpoint-url <YOUR_ENDPOINT_URL>

Using aws s3:

aws s3 rb s3://my-akave-bucket \
  --endpoint-url <YOUR_ENDPOINT_URL>

Notes:

• Make sure your bucket is empty before deleting it. The operation will fail otherwise!
  • Akave has object versioning enabled by default, so to delete objects you must delete each object version. Use the script above in the Empty a Bucket section to delete all versions.
  • Instructions for deleting specific object versions can be found in the Object Versioning and Copying section.