Create a Bucket

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

• The Bucket Types.

• Supported service availability S3 regions.

• To enable Object Lock or not for the bucket.

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

• Web console

• IONOS S3 Object Storage API

• CLI

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.

Contract-owned Buckets

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

Prerequisites:

• 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.

Object lock

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.

User-owned Buckets

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

Prerequisite: 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. You can create user-owned buckets in any of these S3 regions: de, eu-central-2, and eu-south-2 S3 regions.

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.

Object lock

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

6. Click Create bucket.

Result: A user-owned bucket is created in the selected 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.

Contract-owned Buckets

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 https://s3.eu-central-3.ionoscloud.com

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 https://s3.eu-central-3.ionoscloud.com

User-owned Buckets

To create a bucket without an Object Lock

• 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 --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

• 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