You can get started with IONOS Object Storage by completing the initial setup and working with buckets, objects, and access keys.
Start with setting up Object Storage access from the DCD.
Create your first Object Storage bucket to serve as a container to hold data and select whether or not an Object Lock is needed.
Add data as objects in the bucket by uploading them.
View and download the objects to your local device.
Create folders or prefixes in a bucket to organize and manage objects.
Generate access keys to login securely to the Object Storage.
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.
You can upload objects to buckets through one of the following methods:
1. In the DCD, go to Menu > Storage > 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.
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.
Result: The objects are successfully uploaded to the selected bucket.
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 are not subject to these limitations.
Using the , you can perform object upload and manage objects in a bucket.
To upload an object from the current directory to a bucket:
To copy the contents of the local directory my-dir to the bucket my-bucket:
To copy all objects from my-source-bucket to my-dest-bucket, excluding .zip files:
To sync the bucket my-bucket with the contents of the local directory my-dir:
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 does not support multi-part upload due to the upload size limit of 4,65 GiB per object, the and many offer this functionality, allowing users to take advantage of efficiency through parallel uploads.
When creating a bucket, you must carefully consider the following settings:
The .
Supported regions.
To enable or not for the bucket.
The Object Storage bucket can be created through one of the following methods:
aws s3 cp filename.txt s3://my-bucket --endpoint-url https://s3-eu-central-2.ionoscloud.comaws s3 cp my-dir s3://my-bucket/ --recursive --endpoint-url https://s3-eu-central-2.ionoscloud.comaws s3 cp s3://my-source-bucket/ s3://my-dest-bucket/ --recursive --exclude "*.zip" --endpoint-url https://s3.eu-central-2.ionoscloud.comaws s3 sync my-dir s3://my-bucket --endpoint-url https://s3.eu-central-2.ionoscloud.comThe easiest way to create a bucket is by using the DCD. 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.
To create a contract-owned bucket, follow these steps:
1. In the DCD, go to Menu > Storage > IONOS 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 region (Berlin, Germany) and in the us-central-1 region (Lenexa, USA).
3. Enter a unique name for the Bucket name that adheres to the for a bucket.
Note: A bucket will not be created if a bucket with the same name already exists in the IONOS 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 .
6. Click Create bucket.
Result: A contract-owned bucket is created in the selected region.
To create a user-owned bucket, follow these steps:
1. In the DCD, go to Menu > Storage > IONOS 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 Object Storage regions: de
Using the Create Bucket API operation, you can create a bucket with or without the object lock.
For details on configuring the AWS CLI tool, see AWS CLI.
aws s3 mb s3://my-bucket --region eu-central-3 --endpoint-url https://s3.eu-central-3.ionoscloud.comaws s3 mb s3://my-bucket --region us-central-1 --endpoint-url https://s3.us-central-1.ionoscloud.comeu-central-2eu-south-23. 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.
6. Click Create bucket.
Result: A user-owned bucket is created in the selected region.
eu-central-2 region (Berlin, Germany):In the eu-south-2 region (Logrono, Spain):
In the de region (Franfurt, Germany):
In the eu-central-2 region (Berlin, Germany):
In the eu-south-2 region (Logrono, Spain):
1. In the DCD, go to Menu > Storage > 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 in which the folder must be created.
4. Click Create a folder which opens an overlay screen.
5. Enter a name in the Prefix field. The prefix must contain only alphanumeric characters, dashes and hyphens.
6. Click Create to continue with folder creation.
aws s3 mb s3://my-bucket --object-lock-enabled-for-bucket --region eu-central-3 --endpoint-url https://s3.eu-central-3.ionoscloud.comaws s3 mb s3://my-bucket --object-lock-enabled-for-bucket --region us-central-1 --endpoint-url https://s3.us-central-1.ionoscloud.comaws s3 mb s3://my-bucket --region de --endpoint-url https://s3.eu-central-1.ionoscloud.comaws s3 mb s3://my-bucket --region eu-central-2 --endpoint-url https://s3.eu-central-2.ionoscloud.comaws s3 mb s3://my-bucket --region eu-south-2 --endpoint-url https://s3.eu-south-2.ionoscloud.comaws s3 mb s3://my-bucket --object-lock-enabled-for-bucket --region de --endpoint-url https://s3.eu-central-1.ionoscloud.comaws s3 mb s3://my-bucket --object-lock-enabled-for-bucket --region eu-central-2 --endpoint-url https://s3.eu-central-2.ionoscloud.comaws s3 mb s3://my-bucket --object-lock-enabled-for-bucket --region eu-south-2 --endpoint-url https://s3.eu-south-2.ionoscloud.com1. In the DCD, go to Menu > Management, and click Users & Groups.
2. Create a Group or open an existing group from the Groups drop-down list.
3. In the Privileges, select the Use Object Storage checkbox to enable Object Storage permission.
4. In the Members tab, add users to the group that you wish to authorize for the use of the object storage.
Result: All members of the authorized group get the required permission to manage IONOS Object Storage using the DCD.
You need to create a bucket or an Object Storage access key to start using the IONOS Object Storage.
To set up Object Storage through the DCD, follow these steps:
1. In the DCD, go to Menu > Storage > IONOS Object Storage.
The Buckets and Key Management section are shown on the IONOS Object Storage Home page.
2. Click Create a bucket. Creating a new bucket also creates an access key if it does not exist already. For more information, see Create a Bucket.
3. In the Key management, click Generate a key to create a new access key.
Your Object Storage credentials consist of an Access Key and a Secret Key. The DCD automatically uses these credentials to set up Object Storage. These credentials are also required to set up access to IONOS Object Storage using S3 Tools. For more information, see Generate a Key.
Result: The Object Storage is successfully set up through the DCD. On setting up Object Storage, the billing starts only after you upload an object.
Contract owners and administrators may use this functionality to access buckets and objects stored in the IONOS Object Storage accounts of users who are no longer active members of their contracts.
Warning: Before you delete a user or all of their Object Storage access keys from your account, ensure that the content in their IONOS Object Storage is accessible so that you can continue to use it or delete it by adjusting the access rights accordingly.
To access other user's Object Storage, follow these steps:
1. In the DCD, go to Menu > Management, and click Users & Groups.
2. Select the required user from the Users drop-down list.
3.In the Object Storage Keys, click Manage.
Result: You are now logged on as the bucket owner of the selected user's IONOS Object Storage. You can now access the user's buckets, objects, and access keys. You can also update the Object Storage of this user account.
For more billing information, see Pricing Model or contact the IONOS Cloud Support.
Result: The folder is successfully created in the selected bucket.
Create subfolders within a folder by following the steps in Create a folder.
Upload objects to a folder and subfolders.
Search for folders and objects within folders using the Search by Prefix option within a bucket.
An object in the Object Storage can be viewed and downloaded to your local computer. On downloading, the SSE-S3 encryption applied to that object is automatically decrypted before the download process begins. In the case of SSE-C, you need to provide the encryption keys for download. This feature is unavailable in the DCD. You can use the CLI tools, SDK, or API methods to download the objects protected with SSE-C encryption.
You can download objects through one of the following methods:
For large objects, you may not need to download the entire file. You can perform a partial download of objects using the Object Storage API. The API allows you to specify a byte range in your request, enabling you to download only a portion of the object data.
Using the DCD, you can download one object at a time. For downloading multiple objects, consider using CLI tools, SDKs, or REST API.
1. In the DCD, go to Menu > Storage > 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 from which you want to download the object. The list of objects in the bucket is listed.
4. Choose the object to download and click on the respective object's action menu (three dots). The Download option is also available from the respective object's properties page.
5. Click Download. If an object has been shared through a public URL, click the URL to download the object.
Result: The object is successfully downloaded.
Using the , you can download objects from a bucket.
To download my-object.txt to a specified file locally:
To download a specified version of the my-object.txt to a specified file locally:
To download all the objects from the my-bucket bucket to the local directory my-dir:
To recursively copy all objects with the /my-dir/ prefix from my-bucket-1 to my-bucket-2:
To get the object’s metadata without downloading an object:
For more information, see the , , and command references.
aws s3 cp s3://my-bucket/my-object.txt my-object.txt --endpoint-url https://s3.eu-central-2.ionoscloud.comaws s3api get-object --bucket my-bucket --key some-prefix/my-object.txt my-object.txt --version-id fe11a12a-870b-050f-bc9d-3cecefb1f7c4 --endpoint-url https://s3.eu-central-2.ionoscloud.comaws s3 cp s3://my-bucket my-dir --recursive --endpoint-url https://s3.eu-central-2.ionoscloud.comaws s3 cp s3://my-bucket-1/my-dir/ s3://my-bucket-2/my-dir/ --recursive --exclude "*.log" --endpoint-url https://s3.eu-central-2.ionoscloud.comaws s3api head-object --bucket my-bucket --key myobject.txt --endpoint-url https://s3.eu-central-2.ionoscloud.com
An Object Storage key must be generated manually through the DCD or Object Storage Management API. Only upon generating the first key, the Canonical User ID is displayed in the Object Storage Credentials and Users & Groups > Users > Object Storage Keys > IDs section.
To create an access key, follow these steps:
1. In the DCD, go to Menu > Storage > IONOS Object Storage.
2. In the Key management tab, go to the Access keys section and click the Generate key.
3. Confirm key generation by clicking Generate. The keys generated since April 2024 will have access to both contract-owned buckets and user-owned buckets. It works with all .
Result: A new access key for IONOS Object Storage is successfully generated and is in active status by default.
To deactivate or delete keys, see .
1. In the DCD, go to Menu > Management > Users & Groups.
2. Select the user from the Users list and click the Object Storage Keys tab.
3. Click + Generate Key and confirm key generation by clicking OK.
Result: A new access key for IONOS Object Storage is successfully generated for the user and listed in the user's Object Storage Keys tab. By default, the key is in the active status.
From the Object Storage Keys list, click the on the respective key you want to use. Copy the Key value and Secret value from the respective fields to sign in to other Object Storage applications.
To deactivate or delete keys, see .
