S3 API Documentation

Home > S3 Developer Guide > Basic Concepts

Basic Concepts

jQuery(document).attr(“title”, “Welcome to Sterling Kilgore | Results Beyond Words”);

This section provides a brief summary of the basic concepts in cloud object storage.


A region is a cluster deployment of servers, complete with its own API endpoints, networks and compute resources. Currently, IDrive® e2 has 15 regions across US, Canada, Europe, and Asia.


A bucket defines a namespace for 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.


Objects refer to the data stored, such as documents, images, etc. You can also store custom metadata with an object.


Users can be created by the account owner (root user) from the Users tab of IDrive® e2 web console. Account owner can perform the following actions for a user from the web console:

  • Create a new user
  • Delete an existing user
  • Assign access permission for the users i.e. 'Read only', 'Write only' or 'Read and write'.
  • Assign buckets

Access Keys

Before performing any operation either via APIs or clients, users must generate 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 web console.

To create Access keys,

  1. Sign in to the IDrive® e2 account.
  2. Go to 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. Set an expiry date and time for the access key.
  6. Select the access permission for the access key.
  7. Select the buckets to be accessed using the access key.
  8. Click Create Access Key. An Access Key ID and Secret Access 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.

© 2024 IDrive Inc.