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:
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.
Result: The objects are successfully uploaded to the selected bucket.
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.
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 S3 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:
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:
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.
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 not available in the web console, but you can use command-line tools, SDK or API to download 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 properties page in the web console 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 S3 bucket. For more information, see Pricing Model.
Using the web console, you can download one object at a time. For downloading multiple objects, consider using command line tools, SDKs, or REST API.
1. In the DCD, go to Menu > Storage > IONOS S3 Object Storage.
2. From the Buckets list, choose the bucket from which you want to download the object. The list of objects in the bucket is listed.
3. 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.
4. Click Download. If an object has been shared through a public URL, open the URL and download the object from there.
Result: The object is successfully downloaded.
Using the Object Storage API, 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 cp, get-object, and head-object command reference.
When creating a bucket, you must choose the two essential settings:
The bucket region.
To whether or not to enable the Object Lock 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 S3 Web Console. You must create a bucket before you can start uploading objects to the Object Storage.
To create an Object Storage bucket, follow these steps:
1. In the DCD, go to Menu > Storage > IONOS S3 Object Storage.
2. In the Buckets tab, choose the Bucket region which determines the geographical location where the data inside the buckets will be stored. For more information on choosing the right bucket region, see Bucket region.
3. 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. Click Create.
Result: A bucket is created in the selected S3 region.
Using the Create Bucket API, you can create a bucket with or without the object lock.
For details on configuring the AWS CLI tool, see AWS CLI.
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)
Note: Creating a bucket with object lock enabled is currently possible only using command-line tools or Create Bucket API.
For each user, an Object Storage Key is generated automatically, which is activated when the user is granted permission to use the IONOS S3 Object Storage. A maximum of five unique Object Storage Keys can be created per user for different S3 applications. For more information, see Access keys.
Prerequisite: Make sure you have the corresponding permission to create the Object Storage. Only contract owners and administrators with the Object-Storage-Key can set up the object storage.
To create Object Storage keys, follow these steps:
1. In the DCD, go to Menu > Storage > IONOS S3 Object Storage.
2. In the Key management tab, go to the Access keys section and click Generate a key.
3. Confirm key generation by clicking Generate.
Result: A new access key for IONOS S3 Object Storage is successfully generated and is in active status by default.
You can copy the Access Key and Secret Key from the respective fields to sign in to other Object Storage applications.
To deactivate or delete keys, see Manage Keys.
Prerequisite: Make sure you have the corresponding permission to create the Object Storage. Only contract owners and administrators with the Object-Storage-Key can set up the object storage and manage keys for other users.
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.
4. Confirm the action by clicking OK.
Result: A new access key for IONOS S3 Object Storage is successfully generated for the user and is in active status by default.
You can copy Key and Secret from the respective fields to sign in to other object storage applications.
To deactivate or delete keys, see Manage Keys.
You can get started with IONOS S3 Object Storage by completing the initial setup and working with buckets, objects, and access keys.
When you log on to the Object Storage using the , 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 S3 Object Storage. Only contract owners and administrators can enable Object Storage.
1. In the DCD, go to Menu > Management, and click Users & Groups.
2. 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: The Object Storage access keys of each user are activated together with the authorization. All members of the authorized group can now access the IONOS S3 Object Storage using the web console on the DCD.
You need to create a bucket or an Object Storage access key to start using the IONOS S3 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 .
To set up Object Storage through the web console, follow these steps:
1. In the DCD, go to Menu > Storage > IONOS S3 Object Storage. The Buckets and Key Management section are shown on the IONOS S3 Object Storage Home page.
2. Click Create bucket to create a new bucket. Creating a new bucket also creates an access key if it does not exist already. For more information, see .
3. In the Key management, click Generate a key to create a new access key. Your S3 credentials consist of an Access Key and a Secret Key. The web console automatically uses these credentials to set up Object Storage. These credentials are also required to set up access to IONOS S3 Object Storage using . For more information, see .
Result: The Object Storage is successfully set up through the web console. 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 S3 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 S3 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 S3 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.
1. In the DCD, go to Menu > Storage > IONOS S3 Object Storage.
2. From the Buckets list, choose the bucket in which the folder must be created.
3. Click Create a folder which opens an overlay screen.
4. Enter a name in the Prefix field. The prefix must contain only alphanumerical characters, dashes and hyphens.
5. 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.
Note: The objects set to 'private' and have not been removed before the user deletion or if all of the user's Object Storage access keys have been deleted and are no longer accessible to modify the objects; in both these cases, the billing continues to be charged; contact the . For more billing information, see .
Start with setting up Object Storage access from the web console.
Create your first Object Storage bucket to serve as containers to hold data and select whether or not 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 maange objects.
Generate access keys to login securey to the Object Storage.
