Buckets
A bucket is a named container for your files (objects) in IBEE Object Storage. Every object lives in exactly one bucket. A bucket belongs to one workspace, sits in one location, and is private until you choose otherwise. Settings such as public access, CORS and lifecycle rules apply to the whole bucket.
When to use one bucket or several
How it works
- You create a bucket with a name, a location and a storage type. Creation usually takes a few seconds.
- You use it from the portal or any S3 tool, and change its settings on the Settings tab.
- To remove it, you empty it, then delete it.
Before you begin
- Identity verification completed. Until then the portal shows Verify Identity in place of Create Bucket. See Verify your identity.
- For organizations billed in India: a verified payment method. Until then the portal shows Verify payment method in place of Create Bucket. See Verify a payment method.
- Wallet credit or billing set up. See Pricing.
- Permission to create resources in the workspace.
Naming rules
Bucket names must:
- be 3 to 63 characters long;
- use only lowercase letters, numbers and hyphens (
-) — no dots, underscores, spaces or capitals; - start and end with a letter or number;
- be unique within the workspace (other workspaces can use the same name).
Create a bucket
Open Object Storage
In the portal sidebar, click Object Storage under Infrastructure, then Create Bucket.
Enter the bucket name
Under Bucket name, type the name (placeholder my-unique-bucket-name). The hint below reads 3-63 characters, lowercase letters, numbers, and hyphens only.
Choose the location
The Location section has two tabs:
- Automatic: keep Automatic location to let IBEE pick an available location, or click Need a specific location? click here and pick a site. Available sites show their country; pre-order sites show Talk to Sales.
- Specify jurisdiction: This feature is coming soon. For jurisdiction-based placement, talk to sales.
Choosing a pre-order site or the jurisdiction tab changes the footer button to Talk to Sales.
Decide on versioning and Object Lock
Under Versioning and object lock:
With Object lock (WORM) on, choose a default retention mode — None, Governance or Compliance — and for Governance or Compliance a Retention period in days (default 30, at least 1). See Object Locking.
Create a bucket with the API
Use a platform API token with the object-storage.write scope. region is required and must be the Object Storage region identifier for your environment — not a compute site ID or a display name. If you don’t know it, ask support before creating the bucket.
Add "object_lock_enabled": true and "default_retention": {"mode": "GOVERNANCE", "days": 30} to create it with Object Lock. Don’t send site_id.
Verify
The bucket appears in the list on the Object Storage page with its BUCKET name, SIZE and CREATED date. Once you have buckets, the panel at the top shows Buckets, Objects, Storage Used and Bandwidth Egress for the current billing month. Use Search buckets… to filter.
The bucket page
Click a bucket to open it. It has three tabs:
Empty a bucket
Empty bucket permanently deletes every object in a bucket and keeps the bucket and its settings. It runs in the background.
Emptying a bucket can’t be undone. Download anything you need first. Empty bucket isn’t available for buckets with Object Lock or Versioning; delete objects in those with an S3 tool.
Start the job
Click Empty bucket. The dialog says how many objects will be permanently deleted. Type the bucket name and click Empty bucket.
Follow the progress
A status strip shows Emptying bucket… with the count of objects deleted, then Finalizing empty bucket…. Click Cancel to stop it; objects already deleted stay deleted. When it ends you see Bucket contents were deleted, Bucket partially emptied, Some objects are protected, Couldn’t empty bucket or Empty bucket cancelled.
Delete a bucket
Only empty buckets can be deleted. A bucket with objects shows This bucket contains X objects. Empty it first to delete.
- Empty the bucket (above).
- On Settings → General, click Delete bucket in the Danger Zone, or the delete icon in the bucket list.
- Confirm with Delete. The toast Bucket ‘NAME’ deleted successfully appears. This can’t be undone.
A bucket created with Object lock (WORM) can’t be deleted, even when empty: Bucket cannot be deleted because Object Lock is enabled.
Use the API
All bucket operations use https://api.ibee.ai/v1/object-storage with workspace_id and a platform API token:
Objects, folders and per-object retention use the S3 API. Empty bucket and the Public Access URL have no API operation; use the portal.
