Skip to content
OtterScale

Object

The Object page allows you to manage the Ceph Object Gateway (RGW), which provides an S3-compatible object storage interface. You can manage buckets for storing objects and users for controlling access.

The page is divided into two main sections: Bucket and User.

Bucket

Section titled “Bucket”

The Bucket section allows you to manage S3 buckets.

Statistics Overview

Section titled “Statistics Overview”

At the top of the page, you will find a dashboard summarizing the state of S3 storage:

Bucket

The total number of S3 buckets currently defined in the system.

The RGW endpoint IP that clients use to access the bucket via S3-compatible APIs.

Usage

The combined storage consumption across all buckets, including object data and metadata overhead.

Introduction

Section titled “Introduction”

The Bucket table displays a list of all buckets. The table includes the following information:

ColumnDescription
NameThe name of the bucket.
OwnerThe user ID of the bucket owner.
UsageThe total size of objects stored in the bucket.
Created TimeDisplays how long ago the bucket was created, relative to the current time.

Create Bucket

Section titled “Create Bucket”

You can create new buckets to store your data.

  1. Click the Create button.
  2. Name: Enter a unique name for the bucket.
  3. Owner: Select the owner of the bucket from the list of users.
  4. Policy (Optional): Enter a JSON policy to define access permissions. You can use the provided links to generate or reference AWS policies.
  5. Access Control List (Optional): Select a canned ACL (e.g., private, public-read) to define basic access permissions.
  6. Click Confirm to create the bucket.

Access Bucket with S3 Browser

Section titled “Access Bucket with S3 Browser”

This section demonstrates how to access a Ceph Object Gateway (RGW) bucket using S3 Browser, a graphical S3 client. This approach is useful for manual verification, browsing objects, and basic upload/download operations without writing code.

Prerequisites

Section titled “Prerequisites”
  • S3 Browser installed on the client machine (Windows).
  1. Create a user in User section.
  2. Create an access key for the user and copy the secret key.
  3. Create a bucket and assign the user as the owner. The bucket owner always has full control of the bucket regardless of the selected ACL.
  4. Open S3 Browser.
  5. Fill in the account settings:
    • Account type: S3 compatible storage
    • API endpoint: RGW endpoint
    • Access Key ID: User’s access key.
    • Secret Access Key: The copied secret key.
    • Use secure transfer: Disable SSL
  6. Add new account

Manage Buckets

Section titled “Manage Buckets”

You can modify or delete existing buckets using the Actions menu.

Edit Bucket

Section titled “Edit Bucket”

Allows you to update the bucket’s owner, policy, or ACL.

  1. Select Edit from the actions menu (pencil icon).
  2. Update the Owner, Policy, or Access Control List as needed.
  3. Click Confirm to save changes.

Delete Bucket

Section titled “Delete Bucket”

Permanently removes a bucket and all its objects.

  1. Select Delete from the actions menu (trash icon).
  2. Type the name of the bucket to confirm deletion.
  3. Click Confirm to permanently delete the bucket.

User

Section titled “User”

The User section allows you to manage RGW users and their access keys.

Statistics Overview

Section titled “Statistics Overview”

At the top of the page, you will find a dashboard summarizing the state of S3 user management:

User Shares

The total number of S3 users registered in the system.

Introduction

Section titled “Introduction”

The User table displays a list of all users. The table includes the following information:

ColumnDescription
IDThe unique identifier of the user.
NameThe display name of the user.
SuspendedIndicates whether the user account is suspended.
KeyThe number of access keys associated with the user. Clicking the external link icon opens a detailed view of the keys.

Create User

Section titled “Create User”

You can create new users to access the object storage.

  1. Click the Create button.
  2. ID: Enter a unique identifier for the user.
  3. Name: Enter a display name for the user.
  4. Suspend: Toggle to create the user in a suspended state.
  5. Click Confirm to create the user.

Manage Users

Section titled “Manage Users”

You can modify or delete existing users using the Actions menu.

Edit User

Section titled “Edit User”

Allows you to update the user’s name or suspension status.

  1. Select Edit from the actions menu (pencil icon).
  2. Update the Name or Suspend status.
  3. Click Confirm to save changes.

Delete User

Section titled “Delete User”

Permanently removes a user.

  1. Select Delete from the actions menu (trash icon).
  2. Type the ID of the user to confirm deletion.
  3. Click Confirm to permanently delete the user.

Manage Keys

Section titled “Manage Keys”

Access keys are used to authenticate requests to the object storage service. You can view and manage keys by clicking the external link icon in the Key column.

Key List

Section titled “Key List”

The key list displays the following information:

ColumnDescription
Access KeyThe access key ID.

Create Key

Section titled “Create Key”

You can generate new access keys for a user.

  1. Click the Create button within the key management view.
  2. The system will generate a new access key and secret key.

Delete Key

Section titled “Delete Key”

Permanently removes an access key.

  1. Select Delete from the actions menu (trash icon).
  2. Confirm the deletion.