Service Status

The Object Storage Unit (OSU) service is now END OF SALE. For more information, see End-of-Life Policy.

You can enable object versioning in a bucket to create a new version of an object each time you modify it.

When bucket versioning is enabled, a version is created each time an object with the same name as another object contained in the bucket is uploaded, by you or by another user with the appropriate permissions. As buckets only store data, you cannot modify an object inside a bucket.

You can download or delete any version of an object. For more information, see Downloading an Object from a Bucket and Removing Objects from a Bucket.

This feature is not available from Cockpit. This documentation only describes the procedure using AWS CLI.

  • To enable or disable the versioning of a bucket, use the put-bucket-versioning command following this syntax:

    Request sample
    $ aws s3api put-bucket-versioning \
        --profile YOUR_PROFILE \
        --bucket BUCKET \
        --versioning-configuration Status=Enabled \
        --endpoint ENDPOINT

    This command contains the following attributes that you need to specify:

    • (optional) profile: The named profile you want to use, created when configuring AWS CLI. For more information, see Installing and Configuring AWS CLI.
    • bucket: The name of the bucket for which you want to enable or disable the versioning.
    • versioning-configuration: The configuration of the versioning. This element contains the following attribute you need to specify:
      • Status: The versioning state you want to apply to your bucket (EnabledSuspended).
    • endpoint: The endpoint corresponding to the service (oos or osuand Region you want to send the request to, in the following format: https://<SERVICE>.<REGION>

    The bucket versioning is enabled or disabled.

Tutorial: Setting Up a Bucket with Objects

Previous Step:

Creating a Bucket

Next Step:

(optional) Configuring a Bucket ACL

AWS™ and Amazon Web Services™ are trademarks of Amazon Technologies, Inc or its affiliates in the United States and/or other countries.