Frequently Asked Questions

A bucket is a container for storing objects on the cloud. Once you create an IDrive^® e2 account, you can create unlimited buckets and upload objects to them. Object storage has no hierarchy — each object is stored as a URL and includes a unique identifier and metadata.

Note: IDrive^® e2 does not limit bucket size or the number of objects you can upload to a bucket.

To create a bucket,

1. Sign in to your IDrive^® e2 account.
2. On the 'Dashboard' page, select a geolocation from the 'Region' drop-down, for creating buckets. Click 'Enable'.
   
3. Click 'Add New Region' to add more regions. The 'Enabled regions' section in the 'Dashboard' will display all the enabled regions and the corresponding endpoint URL.
4. Click 'Create Bucket' on the dashboard to create a bucket.
   

   Alternatively, you can navigate to the 'Buckets' page and click 'Create Bucket'.

5. In the pop-up window, change the region selected in the drop-down menu if needed.
6. Enable 'Default Encryption' to secure all versions of the backup (recommended).
7. If you wish to lock modification or deletion of any files for a specific duration, enable 'Object Locking'.
   Note: Object locking applies to individual objects. Users can enable/disable locking on any object in a bucket, if object lock is enabled for the bucket.
8. If you want to retain different versions of the files, enable 'Versioning'.
   Note: When you enable 'Versioning', you can choose to enable 'Retention' for a specific bucket under > 'Bucket summary' to prevent accidental deletion of data in a bucket, for a time period.
   
9. Enable 'Retention' to implement rules for object deletion and secure data against accidental deletion. Choose the preferred retention mode, duration, and validity.
   Note: Retention applies to all the objects in a bucket.
10. Once you have configured the bucket, click 'Create Bucket'. The bucket will be created within the chosen region.

After creating a bucket, you can change the bucket access permissions, create a folder inside the bucket, upload objects, rename objects, delete the objects, and delete the bucket.

To change the access permissions,

1. Sign in to your IDrive^® e2 account and navigate to the 'Buckets' tab.
2. Click corresponding to a bucket.
3. Enable/disable 'Default encryption' and 'Object locking' for the bucket.
4. Click 'Update Bucket' to save the access permissions.

To add a folder within the bucket,

1. Click on the bucket where you wish to add a folder.
2. Click .
   
3. Enter a name for the folder and click 'Create'.

To rename objects,

1. Click on the bucket that has the required object.
2. Click corresponding to the object you want to rename.
   
3. Enter the new object name and click 'Rename'.
   

Note: Object name can contain alphanumeric characters and &$=;:+,?!-_.*'()@

To delete objects,

1. Click on the bucket where you wish to delete objects.
2. Select the objects you want to delete and click on the top-right. Alternatively, click corresponding to the file you wish to delete.
   
3. Click 'Delete' in the confirmation popup.

The deletion will occur in the background and it may take a while based on the object size.

To delete all versions of an object,

1. Click on the bucket where you wish to delete objects.
2. Click on the object name to view 'Object details' > 'Versions'.
3. Click next to the versions you want to delete.
   
4. Click 'Delete' to confirm.
   
5. Alternatively, in the bucket, click the on the top-right to see all versions of all objects.
6. Select the versions you wish to delete, and click on the top right, or next to the versions that you wish to delete.
7. Click 'Delete' to confirm.

Similarly, to delete a folder, click corresponding to the folder you wish to delete. In case versioning is enabled, deleting the folder will only delete the current version of objects and not remove the folder. To remove the folder and objects permanentely, select the 'Delete all versions' checkbox in the confirmation window.

To delete a bucket,

1. Hover over the bucket you wish to delete, and click .
2. Click 'Delete' on the confirmation popup.
   

Note:

• A bucket must be empty before deleting it.

To add tags for a bucket,

1. Sign in to your IDrive^® e2 account.
2. Go to 'Buckets', hover on the required bucket and click .
3. Go to 'Summary' > 'Add tags'.
4. Click .
   
5. Enter a key and an associated value for a tag.
6. Click 'Add Tags'.
   

Note: You can add upto 50 tags for a bucket.

IDrive^® e2 does not support Unicode UTF32 characters. Using UTF32 characters (like emoji and other characters) to name an object or bucket will result in an error. To ensure compatibility, IDrive^® e2 recommends using UTF16 characters for naming.

IDrive^® e2 bucket policies are access policies for managing permission to your resources. You can manage
your data by:

• Enabling default encryption
• Setting object lock
• Retaining different versions of the object using versioning
• Implementing retention rules for object deletion

Yes, you can copy the settings from an existing bucket while creating a new bucket.

To copy a bucket's settings,

1. Sign in to IDrive^® e2 account via any browser.
2. On the 'Dashboard' tab, click 'Create Bucket'.
   
   Alternatively, you can navigate to the 'Buckets' tab and click 'Create Bucket'.
3. In the pop-up window, select a region from the 'Choose enabled region' drop-down menu.
   Alternatively, you can also add a new region and define a geolocation for creating a bucket.
4. Enter a bucket name.
5. Select a bucket to copy settings and apply from the 'Quick setup (optional)' field.
   
   All settings related to encryption, access permissions, object locking, and versioning will be copied from the selected bucket and applied to the new bucket.
   Note: If any alterations/changes are made in the settings, it will overwrite the copied settings.
6. Click 'Create Bucket'. A new bucket will be created with the settings from the existing bucket.

Yes, you can replace IDrive^® e2 specific region domain names with your own domain names. You need to
create a CNAME record on your domain name server and point that to your e2 region domain name. The Dashboard on the web console lists the IDrive^® e2 specific domain names for each enabled region.

View CNAME Record Guide

Yes, you can add object lifecycle rules for buckets.

To add a rule,

1. Sign in to your IDrive^® e2 account.
2. Go to the 'Buckets' tab and click corresponding to a bucket.
3. Navigate to 'Object Lifecycle' and click 'Add Rule'.
   
4. Specify a prefix to identify the objects to which the rule will apply.
5. Set rules for current or older versions or expired delete markers. You can either choose a specific duration or date to delete the versions.
   
   
6. Click 'Add Rule'.

To edit the object lifecycle rule, click corresponding to a rule. Modify the rule as required and click 'Update Rule'.

To disable an object lifecycle rule, click corresponding to the rule, and click 'Disable' in the popup.

To delete an object lifecycle rule, click corresponding to the rule, and click 'Delete' in the popup.

Note: Users can also configure object lifecycle rules through S3 APIs.

Yes, IDrive^® e2 does support IP allowlisting for a region. You can control access to data in a region by whitelisting or blocklisting IP addresses.

To enable IP allowlisting,

1. Sign in to your IDrive^® e2 account.
2. Navigate to 'Dashboard' > 'Enabled regions'.
3. Click for the region you want to enable IP allowlisting.
   
4. Go to 'IP allowlisting' tab and use the toggle switch to enable IP allowlisting and click 'Yes' in the confirmation popup.
   
   
5. Click and choose a mode:
   • Whitelisting: Users can access data only using whitelisted IP addresses
   • Blocklisting: Users will not be able to access data using the blacklisted IP addresses
6. Click 'Save'.
   
7. Click 'Add New' to enter an IP address.
8. Enter a name and the IP address and click 'Save'.
   
9. To update or remove an IP address, click or respectively.

Yes, you can implement bucket CORS in IDrive^® e2 to allow only trusted origins (e.g., websites) to load or interact with your bucket's content.

To set up bucket CORS,

1. Sign in to your IDrive^® e2 account.
2. Go to 'Buckets', hover on the required bucket and click .
3. Go to the 'Bucket CORS' tab in the slider.
4. Click 'Add CORS'.
5. Add required CORS configuration in a JSON format and click 'Apply'.
   

In a bucket's CORS configuration, the AllowedMethods element specifies the HTTP methods that are permitted when a cross-origin request is made.

You can include the following values for AllowedMethods:

• GET
• PUT
• POST
• DELETE
• HEAD

IDrive^® e2 implements Cross-Origin Resource Sharing (CORS) headers to indicate any origins other than its own from which a browser should permit loading resources.

To add a rule,

1. Sign in to your IDrive^® e2 account.
2. Go to 'Dashboard' > 'Enabled regions' and click corresponding to a region.
   
3. Go to the 'CORS' tab in the slider window.
   
4. Choose any of the three options:
   • Do not share any files with any origin
   • Share everything in this region with every origin
   • Share everything in this region with specific origins

   Note: Specify multiple origins separated by commas.

5. Click 'Update'.

Note: This feature has been discontinued. You can set up Bucket CORS under Bucket Settings.