Dashboard and buckets

If your question is not addressed below, contact us through our and we will get back to you shortly.

faq What are buckets?
faq How do I create buckets in my IDrive® e2 account?
faq Is it possible to copy the settings from an existing bucket while creating a new bucket?
faq How do I assign public access to a bucket?
faq Where can I get the URL of my IDrive® e2 public bucket?
faq Is it possible to use domain names other than the IDrive® e2 region specific domain names?
faq What are IDrive® e2 bucket policies?
faq Where can I view the endpoints for the IDrive® e2 regions?
faq Does IDrive® e2 support IP allowlisting?
faq Where can I get access keys for using S3 compatible tools to access IDrive® e2?
faq What is object locking in buckets?
faq What is versioning in buckets?
faq What is retention in buckets?
faq What is Legal Hold?
faq What operations can I perform on a bucket in my IDrive® e2 account?
faq How do I copy multiple files simultaneously within a bucket?
faq How do I move or transfer multiple files simultaneously within a bucket?
faq Can I add object lifecycle rules for my buckets?
faq Does IDrive® e2 support Cross-Origin Resource Sharing (CORS)?
faq How do I add objects within a bucket?
faq Can I add tags for an object?
faq How do I retrieve the data stored in my IDrive® e2 account?
faq What is cloud data migration?
faq How do I migrate data from another cloud service provider to IDrive® e2?
faq Are there any conditions that may lead to account termination?
faq I had enabled a region for my account. Why was it removed?

What are buckets?

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.

How do I create buckets in my IDrive® e2 account?

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. Enter a bucket name and configure access as public or 'private'.

    Note: Users with paid subscriptions can enable public buckets after email and phone number verification.

  7. Enable 'Default Encryption' to secure all versions of the backup (recommended).
  8. 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. The S3 client can enable/disabled locking on any object in a bucket, if object lock is enabled for the bucket.
  9. 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.
  10. 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.
  11. Once you have configured the bucket, click 'Create Bucket'. The bucket will be created within the chosen region.

Is it possible to copy the settings from an existing bucket while creating a new bucket?

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.

How do I assign public access to a bucket?

To assign public access to a bucket, you must verify your email address and phone number via a one-time verification code.

  1. Sign in to your IDrive® e2 account, and navigate to 'Buckets' tab.
  2. Click corresponding to a bucket.
  3. In the 'Bucket summary' tab enable 'Public' access by selecting the radio button.
  4. In the pop-up window,
    1. Follow the steps to verify your email address by entering the OTP sent to your registered email address. A green tick mark will indicate successful verification.
    2. Similarly, verify your phone number via the OTP sent to your registered phone number.
  5. On successful verification you will be able to assign the preferred access permission.
  6. Click 'Apply' to save the access permissions.

Note: Users with paid subscriptions can enable public buckets after email and phone number verification.

To optimize the network security and performance of your IDrive® e2 cloud data, check our S3 documentation
for Cloudflare.

Where can I get the URL of my IDrive® e2 public bucket?

Once you assign public access to a bucket, you can view and copy the URL of the same under Bucket Settings.

To view the public bucket URL,

  1. Sign in to your IDrive® e2 account.
  2. Navigate to the 'Buckets' tab.
  3. Click corresponding to a bucket. This will display the 'Bucket summary' slider.
    You can view the URL of your Public bucket under 'Bucket summary' > 'Public Bucket URL'. Click to copy the URL to clipboard.

To view public URL of an object within the public bucket,

  1. Sign in to your IDrive® e2 account.
  2. Navigate to the 'Buckets' tab.
  3. Click the required public bucket to view the objects in it.
  4. Click corresponding to the object you wish to view the public URL.
  5. Click corresponding to 'Public bucket URL' in the object details slider, to copy the URL to clipboard.

Is it possible to use domain names other than the IDrive® e2 region specific domain names?

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

What are IDrive® e2 bucket policies?

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


Note: Users with paid subscriptions can enable public buckets after email and phone number verification.


Does IDrive® e2 support IP allowlisting?

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.

Where can I view the endpoints for the IDrive® e2 regions?

The 'Enabled regions' section on the Dashboard tab displays the endpoint URL for all enabled regions. To add to the enabled regions list, click 'Add New Region', select a region from the dropdown, and click 'Enable'.

Where can I get access keys for using S3 compatible tools to access IDrive® e2?

As the Admin, you can create and manage access keys for your buckets. These keys can be used to access the IDrive® e2 cloud storage via S3 compatible tools.

To create an access key,

  1. Sign in to IDrive® e2 account via any browser.
  2. Navigate to the 'Access Key' tab and click 'Create Access Key'.
  3. Enter a name for the access key.
  4. Select a region from the list of enabled regions in the dropdown list.
  5. Set an expiry date and time for the access key.
  6. Select the access permission for the access key.
  7. Assign buckets, if you want to enable access using these keys. You can choose specific or all buckets.
    Note: By default, all buckets will be selected.
  8. Click 'Create Access Key'. An Access Key ID and Secret Access Key will be generated.

    Download / copy and save the details of the access key.

Note:

  • Access and manage your IDrive® e2 storage using third-party S3 tools from up to 1000 concurrent HTTP connections.
  • You can create up to 250 access keys in a region. Contact support for further assistance.

What is object locking in buckets?

Object locking restricts the modification or deletion of an object. This helps secure the files present in the buckets from any malware or cyber threats. You can enable object locking while creating the bucket.



Note: Object locking applies to individual objects. The S3 client can enable/disabled locking on any object in a bucket, if object lock is enabled for the bucket.

What is versioning in buckets?

When versioning is enabled for a bucket, every modification made to the objects in the bucket will be automatically saved as a new copy or version of the object. Versioning allows you to restore older versions of an object.

To restore versions of an object,

  1. Navigate to the 'Buckets tab', and click the bucket storing the required objects.
  2. Click on the object name to view 'Object details'.
  3. Go to the 'Versions' tab to view all versions of the object. Click next to the version you wish to restore.
  4. Click 'Restore' to confirm.


Alternatively, to restore versions of an object,

  1. In the 'Buckets' tab, click on the top-right of the bucket to see versions of all objects in the bucket.
  2. Select the required versions and click . You can also click next to the version that you want to restore.
  3. The download progress will be displayed in the bottom-right corner.

Note: Click to abort the download.

What is retention in buckets?

When retention is enabled for a bucket, any object uploaded to the bucket will automatically get locked for the duration specified in the bucket retention configuration. Retention can be configured on the web-console while creating the buckets or you can use any S3 compatible client to set various retention policies to the bucket by following S3 JSON protocol based on your requirements.


IDrive® e2 supports the following retention modes:

Governance Mode: This will lock the object for the configured retention policy. However, users can set the "s3:BypassGovernanceRetention" permission to bypass the retention policy and modify or delete files.

Compliance Mode: This will lock the object for the configured retention policy, and no user can modify or delete the object, until that retention policy has expired.

To enable retention for a bucket,

  1. Sign in to your IDrive® e2 account and navigate to the 'Buckets' tab.
  2. Click corresponding to a bucket.
  3. In the 'Bucket Summary' tab, use the toggle switch to enable/ disable 'Retention' to implement rules for object deletion and secure data against accidental deletion.
  4. Choose the preferred retention mode, duration, and validity.
  5. Click 'Update Bucket' to save the access permissions.

Note:

  • Retention applies to all the objects in a bucket.
  • Objects cannot be deleted until the retention policy has expired. Delete operation only removes the object from the default view while a locked version of the object is retained. Click to view and manage the retained version.

What is Legal Hold?

Legal hold is an additional locking mechanism that can be placed on an object in an Object Lock enabled bucket. A legal hold will prevent the modification or deletion of an object indefinitely until the legal hold has been removed. It overrides both Governance Mode, and Compliance Mode retention policies.

However, it does not remove them. After removing the legal hold, the existing Governance Mode, or Compliance Mode retention policy will still be in effect.

What operations can I perform on a bucket in my IDrive® e2 account?

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. You can choose to retain the bucket as 'Private' or 'Public'.

    Note: Users with paid subscriptions can enable public buckets after email and phone number verification.

  4. Enable / disable 'Default encryption' and 'Object locking' for the bucket.
  5. 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.

How do I copy multiple files simultaneously within a bucket?

You can simultaneously copy multiple files from one folder to another folder within a bucket.

To copy the files,

  1. Sign in to your IDrive® e2 account and navigate to the 'Buckets' page.
  2. Click the required bucket. Select the files to copy, and click . A popup will appear.
    Note: You can select only up to 100 files at once.
  3. Choose a folder in the bucket for pasting the copied files. Click if you want to create a new folder to paste the files.
  4. Click 'Paste'.

    The progress will be displayed on the screen. You can click to cancel the ongoing operation.

A success message will be displayed once the files are copied to the selected folder.

Note: IDrive® e2 does not support copying the entire folder.

How do I move or transfer multiple files simultaneously within a bucket?

You can simultaneously move or transfer multiple files from one folder to another folder within a bucket.

To move the files,

  1. Sign in to your IDrive® e2 account and navigate to the 'Buckets' page.
  2. Click the required bucket. Select the required files, and click . A popup will appear.

    Note: You can select only up to 100 files at once.

  3. Choose a folder in the bucket for moving the selected files. Click if you want to create a new folder to move the files.
  4. Click 'Move'.

    The progress will be displayed on the screen. You can click to cancel the ongoing operation.

A success message will be displayed once the files are moved to the selected folder.

Note: IDrive® e2 does not support moving the entire folder.

Can I add object lifecycle rules for my buckets?

Yes, you can add object lifecycle rules for version-enabled buckets.

To add a rule,

  1. Sign in to your IDrive® e2 account.
  2. Click corresponding to a bucket.
  3. In the 'Bucket summary' tab enable 'Public' access by selecting the radio button.
  4. Click 'Add Rule'.
  5. Specify a prefix to identify the objects to which the rule will apply.
  6. Set rules for current or older versions or expired delete markers. You can either choose a specific duration or date to delete the versions.
  7. 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.




Does IDrive® e2 support Cross-Origin Resource Sharing (CORS)?

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 rules' 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 CORS rules'.


How do I add objects within a bucket?

The data you store in your IDrive® e2 account is designated as objects and are assigned metadata and a unique identifier. The size of an object may vary from a few bytes to several gigabytes.

Note: Object name cannot be more than 254 characters.

To add files within a bucket,

  1. Sign in to your IDrive® e2 account and navigate to the 'Buckets' page.
  2. Click on the bucket where you want to store the file.
  3. Click to upload files and to upload folders. You can also use to create a new folder and upload files/folders within it.
  4. Select and upload the files from your computer. The upload progress will be displayed in the bottom-right corner.
    Note: You can click to abort a file upload.

Click corresponding to any object for information such as object size, date of last modification, access level, version ID, and, in the case of public access, also the object URL.

Can I add tags for an object?

Yes, you can add tags for an object. A tag has two parts - key and label. The key must be a unique term used only once as a tag for the object, whereas the value describes the tag further.

To add a tag,

  1. Sign in to your IDrive® e2 account and navigate to the 'Buckets' page.
  2. Click on the bucket where the required file is stored
  3. Click on the object to open the object details.
  4. Click Add tag.
  5. Enter the Tag Key and Tag Label.
  6. Click Save.

How do I retrieve the data stored in my IDrive® e2 account?

Retrieve the data stored in your IDrive® e2 account from anywhere.

To download your files/objects via the IDrive® e2 web console,

  1. Sign in to your IDrive® e2 account.
  2. Navigate to the 'Bucket' page.
  3. Click on the bucket from which you want to retrieve the files.
  4. Select the objects you want to download and click .
    Alternatively, hover over the required object and click .
  5. The IDrive® e2 web console does not provide the folder download option. Use an S3-compatible client to download a folder directory structure, or a large number of files/data. Know more >

What is cloud data migration?

In cloud data migration, you can move the data directly to the IDrive e2 storage from the your cloud storage provider without any additional tools. IDrive® e2 supports source data migration from any S3 compatible storage including AWS, Wasabi, and Backblaze.

How do I migrate data from another cloud service provider to IDrive® e2?

To migrate data to IDrive® e2,

  1. Sign in to IDrive® e2 account via any browser.
  2. Navigate to the 'Data Migration' tab, and click 'Migrate data'.
  3. Select a service provider - AWS, Wasabi, Backblaze, and S3 Compatible Storage - from the dropdown.
  4. Configure the source of migration by selecting the options as applicable:
    1. Access Key ID - Enter the access key for your service provider.
    2. Secret Key - Enter the secret key for your service provider.
    3. Source regions - Select a region from the dropdown or click 'Add Source Endpoint' in the dropdown and add the source endpoint URL.
    4. Source endpoint - Enter the endpoint URL for your service provider.
  5. Click 'Configure Source'.
  6. Select the bucket that you wish to migrate and click 'Next'.
  7. Select the destination region in IDrive® e2 where you want to migrate the data.
  8. Choose a destination bucket or folder from the list or create a new bucket.
  9. Click 'Import'. The process of data migration will start. You can view the progress of the migration, estimated time of completion, and copied object size under 'Status' in the 'Data Migration' tab.
  10. You can pause the data migration by clicking , resume migration by clicking , or delete the migration from the list by clicking . You can also restart a failed migration by clicking .

Note:

  • Altering or modifying the data at the source location while the migration is ongoing can cause data corruption and IDrive® e2 will not be responsible for any such incident.
  • Only the latest version of objects will be migrated.
  • Any deleted objects will not be transferred.

Are there any conditions that may lead to account termination?

If any public bucket is identified or used for phishing attacks or malware, then we have a right to disable the user account. Read our terms and conditions for full details.

I had enabled a region for my account. Why was it removed?

Free trial users can enable as many regions as they want. However, if a region remains inactive and no data is stored in it for more than 30 days, the region will be removed from the account. To keep the region active, you must upload some data to your account in that region.