Create a Bucket

When creating a bucket, you must choose the two essential settings:

• The bucket region.

• To whether or not to enable the Object Lock for the bucket.

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

• Web console

• IONOS S3 Object Storage API

• Command-line tool

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.

To create an Object Storage bucket, follow these steps:

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

2. In the Buckets tab, choose the Bucket region which determines the geographical location where the data inside the buckets will be stored. For more information on choosing the right bucket region, see Bucket 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. Click Create.

Create a bucket

Result: A bucket is created in the selected S3 region.

IONOS S3 Object Storage API

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

Command-line tool

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

To create a bucket without an object lock, follow these commands:

• In the de region (Franfurt, Germany)

aws s3 mb s3://my-bucket --region de --endpoint-url https://s3-eu-central-1.ionoscloud.com

• In the eu-central-2 region (Berlin, Germany)

aws s3 mb s3://my-bucket --object-lock-enabled-for-bucket --region eu-central-2 --endpoint-url https://s3-eu-central-2.ionoscloud.com

• In the eu-south-2 region (Logrono, Spain)

aws s3 mb s3://my-bucket --region eu-south-2 --endpoint-url https://s3-eu-south-2.ionoscloud.com

To create a bucket with an object lock, follow these commands:

• In the de region (Franfurt, Germany)

aws s3 mb s3://my-bucket --object-lock-enabled-for-bucket --region de --endpoint-url https://s3-eu-central-1.ionoscloud.com

• In the eu-central-2 region (Berlin, Germany)

aws s3 mb s3://my-bucket --object-lock-enabled-for-bucket --region eu-central-2 --endpoint-url https://s3-eu-central-2.ionoscloud.com

• In the eu-south-2 region (Logrono, Spain)

aws s3 mb s3://my-bucket --object-lock-enabled-for-bucket --region eu-south-2 --endpoint-url https://s3-eu-south-2.ionoscloud.com

Note: Creating a bucket with object lock enabled is currently possible only using command-line tools or Create Bucket API.