How do I create a versioned bucket in Spaces?

Posted July 12, 2018 4.2k views
Object Storage

The API doc for Spaces says that Bucket Versioning is supported, but only via the API. But I cannot see in the API doc how to create or use a bucket with versioning enabled. Any help appreciated!

These answers are provided by our Community. If you find them useful, show some love by clicking the heart. If you run into issues leave a comment, or add your own answer to help others.

Submit an Answer
3 answers

Hello friend!

Versioning is currently something that you can enable through the S3 compatible Spaces API. Currently this is the best documentation I can locate on the matter:

We typically suggest using s3cmd to interact with the API. However, s3cmd does not seem to currently support this. It never hurts to give an upvote to the request though:

Kind Regards,

After unsuccessfully trying to access the API for a while I managed to set this setting using the official AWS CLI

  1. Get it at
  2. Type aws configure in your terminal and supply your DO credentials (you can leave the region empty)
  3. Run aws s3api list-object-versions --bucket {{ BUCKET_NAME }} --endpoint=https://{{ REGION }}
  • aws s3api list-object-versions merely lists the versions of each object in your space including some additional metadata like ETag.

    aws s3api put-bucket-versioning is used to enable versioning in the AWS CLI v2.

    Something this like works on a normal AWS S3 instance…

    aws s3api put-bucket-versioning --versioning-configuration Status=Enabled --bucket {{ BUCKET_NAME }}

    …but it doesn’t work on a DO Space. As of Apr 4, 2021 (aws-cli/2.1.36) the command fails with…

    An error occurred (InvalidAccessKeyId) when calling the PutBucketVersioning operation: The AWS Access Key Id you provided does not exist in our records.

    Even while using a valid DO Access Key ID (other aws cli commands work just fine).

    There is possible a work-around for this but I can’t see it.

    Anyway, hope this helps someone. Ho hum.

These commands worked for me to enable versioning:

$ aws --profile DOSpaces --endpoint s3api put-bucket-versioning --bucket testbucket --versioning-configuration Status=Enabled

$ aws --profile DOSpaces --endpoint s3api get-bucket-versioning --bucket testbucket

   “Status”: “Enabled”

I got these commands after contacting Digital Ocean support. You can read the full response they wrote me here: