Lyve Cloud Documentation

Managing buckets

Lyve Cloud allows you to store objects (like files) in buckets (like folders). Before you add or store any object, you must create a bucket. When you create a bucket, you must specify the region where you want to create the bucket.

Role-based access to buckets

Bucket access levels are defined by the user roles. The following table describes console access to bucket features based on the user's role:

Actions

Admin

Storage Admin

Auditor (Read only)

Create bucket

×

Edit bucket

×

Delete

×

List and View

Creating buckets

Procedure. To create a bucket:
  1. On the left-hand menu, select Buckets.

  2. On the Buckets page, select Create Bucket.

    CreateBucket.png
  3. Enter the Bucket Name.

    Remember the following while creating a bucket name:

    1. The bucket name must be unique across all of Lyve Cloud.

    2. A bucket name containing a dot (.) is not allowed.

    3. After you create a bucket, you cannot change the bucket name.

  4. Select the Region (Metro) from the drop-down, where you want the bucket to reside. For more information, see Understanding Global Accounts.

    • US - Virginia (us-east-1)

    • US - California (us-west-1)

    • AP - Singapore - (AP-Southeast-1)

    Note

    You must create your first bucket in a region, using the console

  5. Optionally, enable Object Immutability. For more information, see Using object immutability.

    If Object Immutability is not enabled when a bucket is created, you cannot turn it On later. However if you switch it On while creating a bucket, you can later switch it Off and again switch it On.

    If you enable Object Immutability, you can also Set Duration to retain the objects. For more information, see Setting duration.

  6. After you create a bucket, it is listed on the Buckets page.

Note

Sometimes there may be a delay in creating a bucket.

Editing bucket properties

The Buckets page displays the bucket list. It also displays the labels for each bucket, such as Immutable, Versioned, and Logged. For more information on the labels, see Using object immutability and Managing Audit Logs.

Procedure. To edit a bucket:
  1. On the left-hand menu, select Buckets.

  2. On the Buckets page, choose and select the Name to edit.

  3. Perform any of the following actions in the bucket properties:

    • S3 endpoint URL allows copying the S3 endpoint URL to the clipboard. This URL is used to access the bucket. For more information on the S3 endpoint URL see S3 API endpoint.

    • Object Immutability: You may choose to switch Off Object Immutability if it is enabled. For more information, see Using object immutability

      • Set Duration: You can set duration only when Object Immutability is switched On. Select the pencil icon to edit the retention duration. For more information, see Setting duration.

    • S3 API Audit Logs: Select the toggle switch to enable or disable the audit logs for this bucket. For more information on audit logs, see Managing Audit Logs. After you enable the audit logs for the selected bucket, the bucket is labelled as Logged, and once you disable the audit logs, the label is removed.

    • Delete Bucket: Select Delete, to delete a bucket.

      Before deleting a bucket, please make sure to:

      • Delete all data from the bucket.

      • Delete all Permissions referencing this bucket. Deleting a bucket associated with bucket permissions is allowed only if you have applied permission to all buckets or all buckets with a prefix in the account.

      • Verify that the bucket is not set as the target bucket for Audit Logs.

    Edit_bucket-27-11-21.png

Listing buckets

Procedure. To view the bucket list:
  1. On the left-hand menu, select Buckets.

    Note

    This view displays the labels for each bucket, such as Immutable, and Logged. For more information on the labels, see Using object immutability and Managing Audit Logs.

    By default, the Buckets page displays 10 buckets at a time. To increase or decrease the number of buckets per page, select the Rows per page arrow and select 10, 25, 50, or All.

  2. Select the left or right arrow to move between the pages.

    list_bucket_27-11-2021.png

    The following table displays the description to the column names of the bucket list.

    Column Name

    Description

    Name

    Displays the name of the bucket.

    Region

    Displays the region where the bucket is residing. You can select the region while creating a bucket. For more information, see Creating buckets.

    Usage

    Displays the total amount of data stored in the bucket in KiB, MiB, or GiB.

    Created On

    Displays when the bucket was created in YYYY-MM-DD format.

    Immutable, Versioned, Logged

    Displays the bucket labels.

    • Immutable: The label indicates that the bucket is in compliance mode. To disable the compliance mode, see Editing bucket properties

    • Versioned: The label indicates that the bucket is versioned. The bucket version is not suspended even after you disable the Object Immutability

    • Logged: The label indicates that audit logs are enabled for the bucket. To disable the audit logs for buckets, see Editing bucket properties.

    For more information on these labels, see Using object immutability and Managing Audit Logs.

    Video: How to create a bucket