Create a Bucket

When creating a bucket, you must carefully consider the following settings:

The Object Storage bucket can be created through one of the following methods:

Web console

The easiest way to create a bucket is by using the S3 web console. You must create a bucket before you can start uploading objects to the Object Storage.

You can create either a contract-owned bucket or a user-owned bucket but the shift towards a contract-owned bucket model will be the primary focus for future Object Storage updates.

To create a contract-owned bucket, follow these steps:


  • Make sure you have the corresponding permission to create the Object Storage. Only a contract owner or an administrator can create contract-owned buckets.

  • You must have at least one active access key; otherwise, Generate a Key or activate an existing access key.

1. In the DCD, go to Menu > Storage > IONOS S3 Object Storage.

2. In the Buckets tab, click Create a bucket.

3. Choose the Bucket region which determines the geographical location where the data inside the buckets will be stored. Currently, you can create contract-owned buckets only in the eu-central-3 S3 region.

3. Enter a unique name for the Bucket name that adheres to the naming conventions for a bucket.

Note: A bucket will not be created if a bucket with the same name already exists in the IONOS S3 Object Storage.

4. (Optional) Choose whether you want to enable the Object Lock for the bucket. If yes, then select the Enable Object Lock checkbox.

5. If the Object Lock is enabled, select the mode of Object Lock to apply on the objects uploaded to the bucket. Choose from the Governance mode or Compliance mode and input the Retention period in days or years. For more information, see Modes.

Note: When enabling Object Lock, Versioning is enabled for the bucket by default.

6. Click Create bucket.

Result: A contract-owned bucket is created in the eu-central-3 S3 region.

IONOS S3 Object Storage API

Using the Create Bucket API operation, you can create a bucket with or without the object lock.

CLI tool

For details on configuring the AWS CLI tool, see AWS CLI.

To create a bucket without an Object Lock

In the eu-central-3 region (Berlin, Germany):

aws s3 mb s3://my-bucket --region eu-central-3 --endpoint-url

To create a bucket with an Object Lock:

In the eu-central-3 region (Berlin, Germany):

aws s3 mb s3://my-bucket --object-lock-enabled-for-bucket --region eu-central-3 --endpoint-url

Last updated