Upload Objects

When you upload a file to IONOS S3 Object Storage, it is stored as an Object and can be stored in buckets and folders in the Object Storage.

You can upload objects to buckets through one of the following methods:

• Web console

• IONOS S3 Object Storage API

• Command-line tool

Web console

Prerequisites:

• Make sure a bucket already exists to which you want to upload objects (files).

• If you want to use object lock, then make sure the object lock is enabled for the bucket as well. For more information, see Object Lock.

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

2. From the Buckets list, choose the bucket to which objects must be uploaded.

3. Click Upload objects which opens an overlay screen.

4. Click Browse files or drag and drop the files to be uploaded. You can choose to upload multiple files.

Info: The File encryption for objects being uploaded supports Server-Side Encryption with S3 Managed Keys (SSE-S3) and is enabled by default. You can toggle to turn off this option.

5. Review the selected files to be uploaded. Use the Remove and Remove all options to remove any files from being uploaded.

6. Click Start upload to confirm the files to be uploaded.

Upload objects

Result: The objects are successfully uploaded to the selected bucket.

Limitations

A few of the limitations to consider while using object upload through a web console are:

• Multi-part upload is not supported.

• The Server-side Encryption with Customer Provided Keys (SSE-C) is not supported.

• A maximum of 5 GB upload size for a single object applies.

Other applications or the SDKs and APIs are not subject to these limitations.

IONOS S3 Object Storage API

Using the Object Storage API, you can perform object upload and manage objects in a bucket.

Note: Only a single storage class is currently available: STANDARD. It is designed for general-purpose storage of frequently accessed data.

Command-line tool

Prerequisites:

• Set up the AWS CLI by following the installation instructions.

• Make sure to consider the supported S3 Endpoints for object upload.

To upload an object from the current directory to a bucket:

aws s3 cp filename.txt s3://my-bucket --endpoint-url https://s3-eu-central-2.ionoscloud.com

To copy the contents of the local directory my-dir to the bucket my-bucket:

aws s3 cp my-dir s3://my-bucket/ --recursive --endpoint-url https://s3-eu-central-2.ionoscloud.com

To copy all objects from my-source-bucket to my-dest-bucket, excluding .zip files:

aws s3 cp s3://my-source-bucket/ s3://my-dest-bucket/ --recursive --exclude "*.zip" --endpoint-url https://s3-eu-central-2.ionoscloud.com

This command does not support cross-region copying for IONOS S3 Object Storage.

To sync the bucket my-bucket with the contents of the local directory my-dir:

aws s3 sync my-dir s3://my-bucket --endpoint-url https://s3-eu-central-2.ionoscloud.com

Multi-part upload

You can upload and copy objects using the multi-part upload feature that allows you to break down a single object into smaller parts and upload these object parts in parallel, maximizing the upload speed. While the web console does not support multi-part upload due to the upload size limit of 4,65 GB GB per object, the Object Storage API and many S3 Tools offer this functionality, allowing users to take advantage of efficiency through parallel uploads.