Object Storage

In EOS, data files are organized in form of objects in a bucket. A bucket is container just like folders or directories in your OS and allows separation of concerns. For example, you could create a bucket for a personnel app and another one for accounts app. This will enables you to manage permissions and data separately.

To start using EOS for data storage, you must create a bucket.

Create Bucket

1. Sign into My Account
2. Go to Products > Storage option in sidebar menu
3. Click on + Add bucket button
4. Enter a unique bucket name. You must follow these guidelines when choosing the bucket name:

• You must enter a bucket name that is unique across all existing buckets in E2E Object Storage. You can not choose a name that is already in use by another user.
• Names can not be changed after creation. So choose wisely.
• Bucket name must be atleast 3 and no more than 63 chars long.
• Upper case or underscores are not allowed.
• Do not format bucket names like ip address (for example, 10.10.10.2).

5. Click Create
6. You will be re-directed to object browser.

Hint

You will not be charged for empty buckets.

Now that your bucket is ready, you may choose to Upload files through object browser or set bucket permissions to enable CLI access.

Bucket Actions

There is five actions in Bucket

1. Object Versioning
2. Lifecycle Rule
3. Replication Rule
4. Empty
5. Delete

Object Versioning

E2E provide Object Versioning feature in Object storage using this feature users can upload duplicate file which will store in minio side with version. For enabling versioning you need to click on Action button and click on Object versioning.

Lifecycle Rule

E2E provide Lifecycle Rule feature in Object storage using this feature users can apply lifecyle rule on bucket after applying this the object will delete as per your set rule. For that users need to click on Action button and click on Lifecycle Rule and enter details and click on save.

Replication Rule

E2E provide Replication rule feature in Object Storage using this feature users can transfer their Object to one region to other region bucket. For enable replication rule you need to click on Action button and click on Replication rule. And enter required details and click on save button.

Note

For enabling replication rule feature the versioning must be enable for that bucket.

Users can perform actions on Replication bucket by clicking on Action button. The action would be Delete and Disable.

Replication of Bucket between 2 regions

To sync/replicate the data between Nodida region and Mumbai region please follow the below mentioned.

Create a bucket in Noida region.

Create a bucket in Mumbai region .

Please concentrate on the source region Object Storage to manage.

Please try creating access key on Source region, as we started with Delhi at source we will first create the access key at Delhi.

The next step will be attaching the access ket with the bucket.

Let us now set the public access permissions as per our requirements.

Next we have to set the Object Versioning.

We can set the lifecycle rules.

Next step will be we have to set the Replication rule and selet the destination bucket.

Then try to upload and file in the source by mentioning the destination path.

After the successfully uploading, the file will be successfully synced/replicated in the destination bucket.

Empty Bucket

Using Empty action user can empty the bucket. The object will delete from the bucket.

Bucket Details

In Bucket details the all details of bucket will show.

Objects

In Objects the list of object will be show. And customers can upload object from here and perform Actions on that.

Permissions

In permissions tab the permission details will show and customers can apply permission on the bucket using access key and perform actions on that.

Access Key

If you intend to use CLI or API for accessing your data on EOS then you will need to define bucket permissions.

Customers can create access keys using Manage Access Keys and using Permission tab

Using Manage Access Key

Using Manage access key you need to click on Manage Access Keys button.

Actions in Manage Access Key

Customers can perform two actions in Access key is Lock, Unlock and Delete

1. Go to Products > Storage Storage option in the sidebar menu

2. Choose any bucket or create a new one.

3. Click the permission tab, it will be opened for the selected bucket.

4. Click the Create access key button.

5. Enter a name for your access key. This can be an application name, project name or a team member name.

6. Choose an access key or Create access key.

7. Assign a role:

   bucket admin	can read, write, manage
   bucket writer	can read, write
   bucket reader	can read

Public Access Config

Usin Public access config we give the permissions of Upload, Download, Upload & Dowload and Private for the objects using URL. For Enable this you need to click on Public Access Config button and select permission which you want give.

Bucket Lifecycle

In this section the lifecycle rule will be show whatever you have created and you can also create and perform action on this.

Bucket Details

In this section the details of bucket will be show.

Bucket Permissions

If you intend to use CLI or API for accessing your data on EOS then you will need to define bucket permissions.

1. Go to Products > Storage Storage option in the sidebar menu

2. Choose any bucket or create a new one.

3. Click the permission tab, it will be opened for the selected bucket.

4. Click the Create access key button.

5. Enter a name for your access key. This can be an application name, project name or a team member name.

6. Choose an access key or Create access key.

7. Assign a role:

   bucket admin	can read, write, manage
   bucket writer	can read, write
   bucket reader	can read

5. Save the permission.

Create access key

You can create access key from Permissions tab on Bucket details page or Manage access page.

1. Enter a name for your access key. This can be an application name, project name or a team member name.
2. Click Generate Key.
3. If all goes well, you will see newly generated access and secret keys
4. Keep a note of both these keys as you will not see them again after you close the modal window.
5. If you have mc setup then use the given command to configure CLI for this access key.

Hint

Choose a short name for access key as you will be entering this for each command that you type in CLI.

Manage Access

Sometimes you may need to disable access for certain users or target applications. The way to do that is to lock their access key from manage access page.

1. Go to Products > Storage Storage option in the sidebar menu
2. Click Manage Access Key
3. Identify the access you want to lock using key name
4. Click lock icon as desired

To unlock, follow the same steps above except this time you will see an unlock icon instead of lock.