Dashboard and buckets

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

faq What are buckets?
faq How do I create buckets in my IDrive® e2 account?
faq What are IDrive® e2 bucket policies?
faq Where can I view the endpoints for the IDrive® e2 regions?
faq Is it possible to use domain names other than the IDrive® e2 region specific domain names?
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 operations can I perform on a bucket in my IDrive® e2 account?
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 How do I retrieve the data stored in my IDrive® e2 account?

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

    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.

  3. Navigate to the 'Buckets' page and click 'Create Bucket'. Alternatively, you can click 'Create Bucket' right from the 'Dashboard' page.
  4. In the pop-up window, change the region selected in the drop-down menu if needed.
  5. Enter a bucket name and configure access as public or private.
    Note: Only paid accounts can configure a bucket for public access. Free accounts will not be able to use this feature.
  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. The S3 client can enable/disabled 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.

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: Only paid accounts can configure a bucket for public access. Free accounts will not be able to use this feature.


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

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.

Note: This feature is only available on paid plans.

View CNAME Record Guide

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. Select the access permission for the access key.
  6. 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.
  7. 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.

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.


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


Note:

  • Retention applies to all the objects in a bucket.
  • If an object is deleted, then the current version of the object will get deleted but a locked version of the object is retained. You can view the versions by clicking on the show versions button.

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.

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, 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' page
  2. Click corresponding to a bucket.
  3. You can choose to retain the bucket as 'Private' or select the radio button 'Public' to enable public access.
  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 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.

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, hover over the bucket and click and click 'Delete' in the confirmation popup.

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. Go to the 'Object lifecycle' tab in the slider window.
  4. Click 'Add Rule'.
  5. Specify a prefix to identify the objects to which the rule will apply.
  6. Set rules for current and older versions. 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 1024 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.

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

You can retrieve your data stored in your IDrive® e2 account from anywhere.

To download your files,

  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. You can also use your existing S3 compatible tool to download the files. Know more >