Upload Objects

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

DCD

To upload objects to buckets, follow these steps:

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 & Backup > IONOS Object Storage.

2. From the drop-down list in the Buckets tab, choose either Show user-owned buckets or Show contract-owned buckets depending on the bucket type you want to view.

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

4. Click Upload objects which opens an overlay screen.

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

Browse files to upload

Info: During object upload, you can turn on or off Server-Side Encryption with Object Storage Managed Keys (SSE-S3) for user-owned buckets. The object upload via DCD does not support encryption for contract-owned buckets.

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 the DCD are:

• A maximum of 4,65 GiB upload size for a single object applies.

• Due to the upload size limit, multi-part uploads are not supported.

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

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

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.

CLI

Prerequisites:

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

• Make sure to consider the supported 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

Info: This command does not support cross-region copying for IONOS 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. The Object Storage API and many S3 Tools offer this functionality, allowing users to take advantage of efficiency through parallel uploads.