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:

DCD

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

Info: During object upload, you can turn on or off Server-Side Encryption with S3 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:

  • Multi-part upload is not supported.

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

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

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

Info: 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 DCD does not support multi-part upload due to the upload size limit of 4,65 GiB per object, the Object Storage API and many S3 Tools offer this functionality, allowing users to take advantage of efficiency through parallel uploads.

Last updated

Revision created

commented latest release