IDrive® e2 is a fast, reliable and affordable object storage solution with S3 API compatibility. It can be integrated easily with your existing applications, data management tools, and S3 gateways.

The terms listed below will be required while using S3 API or clients for accessing IDrive® e2.


Basic concepts

A summary of the basic concepts in IDrive® e2 cloud object storage


Region

A region is a cluster deployment of servers. Each region has exclusive API endpoints, networks, and compute resources. Currently, IDrive® e2 has 8 regions in the US.

To enable a region,

  1. Sign in to your IDrive® e2 account. The Dashboard tab will be displayed.
  2. Select a geolocation from the Region drop-down for creating buckets.
  3. Click Enable. The region will be added to your account.
  4. Go to the Enabled regions section in the Dashboard to view the endpoint URL for a region. This endpoint URL is unique for every user.

Buckets

A bucket defines a namespace for containing objects. An object with the same name in two different buckets represents two different objects. You can create any number of buckets within an account.

To create a bucket,

  1. Sign in to your IDrive® e2 account.
  2. Click on the Buckets tab and click Create Bucket.
    You can also click Create Bucket right from the Dashboard tab.
  3. In the pop-up window,
    • Change the region selected in the drop-down menu if needed.
    • Enter a bucket name.
    • Enable Default Encryption to secure all versions of the backup (recommended).
    • Enable Object Locking if you wish to lock modification or deletion of any files for a specific duration.
    • Enable Versioning if you want to retain different versions of the files.
      Note: When you enable Versioning, you can choose to enable Retention to implement rules for object deletion and secure data against accidental deletion. Choose the preferred retention mode, duration, and validity.
  4. Once you have configured the bucket, click Create Bucket. The bucket will be created within the chosen region.

Objects

Objects refer to the documents, images, etc stored in the buckets. You can also store custom metadata with an object.

To upload an object to a bucket,

  1. Sign in to your IDrive® e2 account.
  2. Click the Buckets tab.
  3. Click on the required bucket, where you want to upload the object.
  4. Click .
  5. 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.

Access Keys

Before performing any operation either via APIs or clients, users must generate or be assigned the Access Key & Secret Key, which will be used to confirm the identity of a user.

These keys can be generated from the Access Keys tab of the IDrive® e2 account.

To create S3 an Access Key,

  1. Sign in to the IDrive® e2 account.
  2. Click on the Access Keys tab.
  3. Click Create Access Key.
  4. Enter a name for the access key and select a region from the list of enabled regions in the dropdown list.
  5. Select the access permission for the access key.
  6. Select the buckets to be accessed using the access key.
  7. Click Create Access Key. An access key and secret key will be generated. Download/copy to save the details.
    Access Key roles and rights cannot be edited. To edit access roles or access rights to buckets, delete the Access Key and create a new one.

Sub-accounts (users)

Sub-accounts can be created by the account owner (Admin) from the Users tab of the IDrive® e2 account. The Admin can perform the following actions on a sub-account from the account:

  • Create a new sub-account
  • Delete an existing sub-account
  • Configure S3 API access roles
  • Assign/ revoke access to buckets
  • Grant/ revoke the account access

To invite users via email, refer to the FAQ.