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:
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 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 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.
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 SDKs and APIs are not subject to these limitations.
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.
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:
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:
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:
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.
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.
Result: The folder is successfully created in the selected bucket.
Note:
— A folder once created, cannot be renamed.
— Objects that have already been uploaded cannot be moved to a different folder.
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.
When you log on to the Object Storage using the DCD, the DCD manages authentication and authorization so that you can access the object storage with just one click.
Prerequisite: Make sure you have the corresponding privilege to enable IONOS Object Storage. Only contract owners and administrators can enable Object Storage.
1. 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.
Prerequisite: The Use Object Storage permission must be enabled for the user account. The Object Storage is not enabled for an IONOS account by default. For more information, see Enable Object Storage access.
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.
Note:
— The contract is charged for data stored even if all the Object Storage keys are deleted. However, you can create a new key and continue to work with Object Storage.
— You need to delete all the objects from the user-owned bucket before you delete a user or all of their Object Storage Keys from your account; otherwise, the contract continues to be charged for the stored data.
For more billing information, see Pricing Model or contact the IONOS Cloud Support.
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:
The 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:
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, or an existing access key.
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.
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 eu-central-3 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, eu-central-2, and eu-south-2.
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.
6. Click Create bucket.
Result: A user-owned bucket is created in the selected region.
In the de region (Franfurt, Germany):
In the 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):
An Object Storage key must be generated manually through the DCD or . Only upon generating the first key, the Canonical User ID is displayed in the and Users & Groups > Users > Object Storage Keys > IDs section.
Prerequisite: Make sure you have the corresponding permission to manage the Object Storage. If you are not the contract owner or the administrator, you must be added to a group with Use Object Storage privilege.
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.
Result: A new access key for IONOS Object Storage is successfully generated and is in active status by default.
Info: It is recommended to download the Access Key and Secret Key as a backup copy by using the Download key pair option. Using the key details, you can sign in to other Object Storage applications. A maximum of five unique Object Storage Keys can be created per user for different S3 applications.
Prerequisite: Make sure you have the corresponding permission to manage the Object Storage. If you are not the contract owner or the administrator, you must be added to a group with Use Object Storage privilege.
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.
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.
Note: An object's metadata can be viewed directly from the page in the DCD or through the API call, providing a quick way to inspect an object's properties without incurring data transfer fees. Data transfer fees apply when you download objects from your Object Storage bucket. For more information, see .
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.
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:
Note: When enabling Object Lock, is enabled for the bucket by default.
Prerequisite: You must have at least one active access key; otherwise, or an existing access key.
3. Enter a unique name for the Bucket name that adheres to the for a bucket.
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 .
Note: When enabling Object Lock, is enabled for the bucket by default.
Using the API operation, you can create a bucket with or without the object lock.
For details on configuring the AWS CLI tool, see .
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 .
To deactivate or delete keys, see .
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 .
Using the , you can download objects from a bucket.
For more information, see the , , and command references.
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.
