Buckets

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

Basics

faq What are buckets?
faq How do I create buckets in my IDrive® e2 account?
faq What operations can I perform on a bucket in my IDrive® e2 account?
faq Does IDrive® e2 support Unicode UTF32 characters?
faq What are IDrive® e2 bucket policies?

Public Buckets

faq How do I assign public access to a bucket?
faq Are there any guidelines for sharing files for public use with IDrive® e2 buckets?
faq Where can I get the URL of my IDrive® e2 public bucket?

Bucket Management & Configuration

faq Is it possible to copy the settings from an existing bucket while creating a new bucket?
faq Is it possible to use domain names other than the IDrive® e2 region specific domain names?
faq Can I add object lifecycle rules for my buckets?
faq Does IDrive® e2 support IP allowlisting?
faq Does IDrive® e2 support Cross-Origin Resource Sharing (CORS)?

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 'Private'.

    Note: By default, public use of a bucket, folder, or file is allowed only by certain paid (not trial) accounts.
    Learn more

  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. Users can enable/disable 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.

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: By default, public use of a bucket, folder, or file is allowed only by certain paid (not trial) accounts.
    Learn more

  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.

Does IDrive® e2 support Unicode UTF32 characters?

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.

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: By default, public use of a bucket, folder, or file is allowed only by certain paid (not trial) accounts.

IDrive e2

How do I assign public access to a bucket?

Effective from 11-01-2024, IDrive® e2 has updated its default policy regarding bucket access. For all accounts created after this date, the ability to set a bucket as public is disabled by default.

To enable this feature you will need to send a request to IDrive® e2 support. We will assess your use case and enable the feature if it is in line with our intended use guidelines. Sharing copyrighted content, malware, deceptive or spam websites is strictly prohibited. Learn more about guidelines for sharing files for public use via buckets.

For paid user accounts created before 11-01-2024

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.

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

Are there any guidelines for sharing files for public use with IDrive® e2 buckets?

Yes, when sharing files publicly with IDrive® e2, it is essential to consider the following guidelines to ensure compliance with copyright and legal standards:

  1. Copyrighted Content
    Only share files for which you have the necessary rights or permissions. Unauthorized sharing of copyrighted material can violate copyright laws, potentially resulting in legal repercussions.
  2. Fair Use
    Some regions recognize "fair use" or "fair dealing" exceptions that allow limited sharing of copyrighted content under specific conditions, such as for educational use, sharing criticism, or creating parody content. Note that fair use policies vary widely and may not apply universally.
  3. Compliance with DMCA and Similar Laws
    Laws like the Digital Millennium Copyright Act (DMCA) establish protocols for copyright takedown requests online. If you publicly share content that violates copyright, IDrive will remove it if we receive a valid complaint from the copyright holder.

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 IDrive e2 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 IDrive e2 to copy the URL to the clipboard.
    IDrive e2

To view the 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 IDrive e2 corresponding to the object you wish to view the public URL.
    IDrive e2
  5. Click IDrive e2 corresponding to 'Public bucket URL' in the object details slider, to copy the URL to the clipboard.
    IDrive e2

A public bucket URL consists of three components:

Example: https://j8g8.c12.e2-1.dev/100plus/03_01_49_04IMG_0019JPG

  • Bucket URL: https://j8g8.c12.e2
  • Bucket Name: 1.dev
  • Object Name: 03_01_49_04IMG_0019JPG

Note:

  • Object inside a folder: The URL follows this format: FolderName/ObjectName (e.g., Test/03_01_49_04IMG_0019JPG).
  • Object in the root directory: Only the object name appears in the URL (e.g., 03_01_49_04IMG_0019JPG).

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.

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

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. Go to the 'Buckets' tab and click corresponding to a bucket.
  3. Navigate to 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. 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.




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 IDrive e2 for the region you want to enable IP allowlisting.
    IDrive e2
  4. Go to 'IP allowlisting' tab and use the toggle switch to enable IP allowlisting and click 'Yes' in the confirmation popup.
    IDrive e2
  5. Click IDrive e2 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'.
    IDrive e2
  7. Click 'Add New' to enter an IP address.
  8. Enter a name and the IP address and click 'Save'.
    IDrive e2
  9. To update or remove an IP address, click IDrive e2 or IDrive e2 respectively.

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