Skip to content

Buckets ​

A bucket is the top-level container of the S3-compatible Object Storage based on Ceph RGW. In the Storage app, open Object → Buckets in the left sidebar to create, view, and manage buckets, and to upload, download, and delete the objects (files) inside them.

Bucket List ​

Selecting Buckets in the sidebar shows the buckets you have access to. You can search for a bucket or create a new one at the top.

  • Search: Filters buckets by attributes such as name.
  • Sort: The default order is newest first. Click a column header to change the sort.

Use the left sidebar to move between the Storage screens (Dashboard and Buckets). Buckets is under the Object group.

Sidebar (SNB)
No.FeatureItemDescription
1-1DashboardDashboard· A summary of storage inventory, capacity, and object performance statistics.
1-2BucketsBuckets· List, create, view, and delete Object Storage buckets.

Search and actions ​

Search for buckets, delete the selected ones, or create a new bucket.

Search and actions
No.FeatureItemDescription
2-1SearchSearch buckets by attributes· Filters buckets by attributes such as name.
2-2Delete selectedDelete· Deletes the buckets selected with the checkboxes (disabled when nothing is selected).
2-3Create bucketCreate bucket· Goes to the page for creating a new bucket.

Bucket list table ​

The list of created buckets.

Bucket list table
No.FeatureItemDescription
3-1List columnsNameBucket name (click to open the details).
Used capacityCapacity used by the bucket.
ObjectNumber of stored objects.
Created atBucket creation date.
ActionRow menu: Edit and Delete.

Create Bucket ​

Create button ​

Click to go to the bucket creation page.

Create button

Bucket creation form ​

Fill in the steps in the order Basic information → Settings → Policy, clicking Next after each. The Summary on the right marks finished steps, and Create is enabled only after all three.

Bucket creation form
No.FeatureItemDescription
2-1Basic informationBasic information· The step for required information such as the bucket name and region.
2-2Bucket nameBucket name *· 3–63 characters using only lowercase letters, numbers, hyphens (-), and periods (.). Must start and end with a lowercase letter or number. Cannot be changed after creation.
2-3RegionRegion *· The region for the bucket (currently fixed to default).
2-4SettingsSettings· The step for object locking, tags, and the placement target (opens when you click Next on the previous step).
2-5PolicyPolicy· The step for access policies such as the bucket policy (JSON) and ACL.
2-6Cancel / CreateCancel / Create· Create: creates the bucket (enabled after all three steps). Cancel: returns to the list.

The create screen has three steps: Basic information → Settings → Policy. Fill in a step and click Next; that step collapses and the next one opens. The Summary on the right marks each finished step, and the Create button is enabled only after you have gone through all three.

  1. Click Create bucket on the bucket list.
  2. In Basic information, enter the bucket name and click Next.
  3. In Settings, set object locking, tags, and the placement target, then click Next. If there is nothing to change, just click Next.
  4. In Policy, set the bucket policy and ACL, then click Next. If there is nothing to change, just click Next.
  5. Click Create under the Summary on the right.

You can reopen a finished step with its Edit button. If you click Cancel or try to leave while entering values, an "Unsaved changes" confirmation appears.

Basic information ​

FieldRequiredDescription
Bucket name✓Unique bucket name. Follows the name rules below.
Region✓Region for the bucket. Currently fixed to default, so there is nothing to choose.

Name Rules ​

  • 3-63 characters
  • Only lowercase letters, numbers, hyphens (-), and periods (.)
  • Must start and end with a lowercase letter or number
  • No spaces and no consecutive periods (..)

Warning

Bucket names must be unique and cannot be changed after creation.

Settings ​

FieldDescription
Object lockingA write-once-read-many (WORM) lock that prevents objects from being deleted or overwritten for a set period. Off by default. When turned on, Mode and Days are required. It can only be set at creation and cannot be changed later.
TagsAdd key-value pairs with Add tags.
Placement targetThe storage type for objects: nvme (default) or hdd. You can move to the next step without choosing. It cannot be changed after creation.

When object locking is on, you set the following.

ItemDescription
ModeCompliance or Governance. Hover over the info icon next to each mode for an explanation.
DaysThe default retention period applied to newly placed objects. 1-36500 days

Versioning and MFA delete

Versioning and MFA delete are not on the create screen. Turn them on in Edit Bucket after creating the bucket.

Policy ​

FieldDescription
Bucket policyEnter the bucket access policy as JSON. The default is the empty policy {}; Clear removes what you entered.
ACLChoose a Grantee and Permissions. The default is Owner with Full control.

ACL options: the permissions you can choose depend on the grantee.

GranteeAvailable permissions
OwnerFull control
EveryoneRead / Read and write
Authenticated userRead

Bucket Details ​

Click a bucket name in the list to open its details. The top shows a summary of the used capacity, object count, and creation time with Edit and Delete buttons, and below are the Details / Policies / Objects tabs.

Open the details (click the name) ​

Click a bucket name in the list to open its details.

Open the details (click the name)

Bucket details (tabs) ​

View and manage the bucket summary, details, policies, and objects.

Bucket details (tabs)
No.FeatureItemDescription
2-1Edit / DeleteEdit / Delete· Edit: change the bucket settings. Delete: opens the bucket deletion dialog.
2-2Summary cardsUsed capacity · Objects · Created at· A summary of the bucket usage, object count, and creation time.
2-3Details tabDetails· Basic information such as region, versioning, object locking, MFA delete, encryption, index type, placement rule, tags, and capacity/object limits.
2-4Policies tabPolicies· View the bucket policy (JSON), lifecycle, replication policy, and ACL (grantee/permissions).
2-5Objects tabObjects· Create, upload, download, move, and delete the objects (files) and folders in the bucket.
TabContents
DetailsRegion, versioning, MFA delete, encryption, object locking, index type, placement rule, tags, capacity limit %, object limit %
PoliciesBucket policy (JSON), lifecycle, replication policy, and ACL (grantee / permissions). View only.
ObjectsManage the objects (files) and folders in the bucket. See Manage Objects.

Edit Bucket ​

Open it from the row action menu in the list or with the Edit button on the detail screen. The edit screen has two areas, Settings and Policy; click Edit on an area to change its values.

AreaFieldEditableNotes
—Bucket name✕Cannot be changed after creation (display only)
SettingsVersioning✓Keeps previous versions of objects uploaded with the same key.
SettingsMFA delete✓Can be turned on only while versioning is on. You enter the MFA token details when turning it on.
SettingsTags✓
PolicyBucket policy, ACL✓Entered the same way as at creation.

Object locking and the placement target do not appear on the edit screen. The values set at creation are kept.

Manage Objects ​

On the Objects tab of the bucket details, view the objects (files) and folders in the bucket and upload, download, and delete them.

Folder navigation ​

  • A folder tree on the left of the tab lets you move by clicking a folder. The tree can be collapsed.
  • The current location is shown as a path above the list.

Object list ​

ColumnDescription
Name (= key)Object key (file name or folder name)
OwnerOwner
Typefile or folder
SizeObject size. - for folders
Storage classFor example, STANDARD
ETagIdentifier of the object contents. - for folders
Last modifiedLast modification time
ActionRow action menu

Top actions ​

ActionWhat it does
Create folderEnter a folder name and choose where (the parent folder) to create it.
Create objectChoose the location, then pick what to upload with Choose file or Choose folder. You can add tags while uploading.
Download objectsDownloads the objects selected with the checkboxes.
DeleteDeletes the objects selected with the checkboxes. Disabled when nothing is selected.

Row actions ​

TargetActionDescription
FileEdit fileChanges the file name and tags.
FileCopy S3 uriCopies the address in the form s3://{bucket}/{key}.
FileCopy URLCopies the HTTP address.
FileMove objectsMoves it to another folder.
FileDownloadDownloads the file.
FileDeletePermanently deletes the file. This cannot be undone.
FolderEdit folderEdits the folder information.
FolderMove folderMoves it under another folder.
FolderDownloadDownloads the objects in the folder.
FolderDeleteDeletes the folder. If it is not empty, a warning says all objects in it will be deleted too; this cannot be undone.

Delete Bucket ​

  1. In the bucket list, open the Action (⋯) menu on the bucket row and choose Delete (or use the Delete button on the detail screen).
  2. Check the bucket in the confirmation dialog and click Delete.

Open delete (row action) ​

Choose Delete in the row action (⋯) menu (menu: Edit / Delete).

Open delete (row action)

Delete confirmation dialog ​

Deletes the bucket and every object stored in it. This cannot be undone.

Delete confirmation dialog
No.FeatureItemDescription
2-1Delete noticeTarget bucket and warning· The bucket to delete and the warning that its objects are deleted too.
2-2Cancel / DeleteCancel / Delete· Delete: deletes permanently. Cancel: closes the dialog.

Danger

Deleting a bucket deletes every object stored in it, and this cannot be undone.

The New Standard for AI Infrastructure