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 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. 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: 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 Enable Object Storage access.
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 Create a Bucket.
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 S3 Tools. For more information, see Generate a Key.
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.
Note: The billing for your Object Storage continues to be charged in the following two cases:
The objects are set to 'private' and have not been removed before the user deletion.
All of the user's Object Storage access keys have been deleted and are no longer accessible to modify the objects.
For more billing information, see Pricing Model or contact the IONOS Cloud Support.
You can get started with IONOS S3 Object Storage by completing the initial setup and working with buckets, objects, and access keys.
Start with setting up Object Storage access from the web console.
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 creating a bucket, you must carefully consider the following settings:
To enable Object Lock 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 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. (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.
Note: When enabling Object Lock, Versioning is enabled for the bucket by default.
6. Click Create bucket.
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)
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.
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 alphanumeric 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.
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
privilege 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.
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 web console, but you can use CLI 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 CLI 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, click the URL to download the object.
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 the cp, get-object, and head-object command references.