Skip to navigation

An object is a single file stored in a bucket, together with its details: size, content type and last-modified date. Each object is found by its key, the full name inside the bucket, such as reports/2026/may.pdf. This page shows how to upload, download, organize and delete objects in the portal and with S3 tools.

When to use the portal or an S3 tool

You want to…UseLimit
Upload a few files, or a folder, by handThe portal300 MB per file
Upload big files, many files, or on a scheduleThe AWS CLI, rclone or an SDK5 GiB per request; bigger files go up in parts automatically
Let someone else upload or download one fileA presigned URL1 second to 7 days
Delete everything in a bucketEmpty bucket — see BucketsNot for Object Lock or versioned buckets

How it works

  1. An upload writes the whole file under its key. Uploading to a key that already exists replaces the file.
  2. “Folders” are just the part of a key before a /. The portal shows them as folders so you can browse.
  3. A download reads the whole file, or a byte range of it.

Before you begin

  • A bucket. See Create a bucket.
  • For the portal: write access to the workspace (without it, Upload and Create Folder aren’t shown).
  • For S3 tools: an S3 credential with Object Read & Write (or Admin Read & Write) for the bucket, and the AWS CLI set up with region auto and path-style addressing as in Using the S3 API.

Upload in the portal

1

Open the bucket

In Object Storage, click the bucket’s name. The Objects tab opens.

2

Choose the files

Click Upload to pick files, or open the arrow next to it and choose Upload files or Upload folder. You can also drag files onto the list. An empty bucket or folder shows Upload Files and Upload Folder buttons instead.

3

Watch the upload

An upload panel shows each file’s progress; you can cancel a running upload there. Files over 300 MB are refused with Files larger than 300 MB must be uploaded via the API.

4

Check the result

The files appear in the list with their Type, Storage Class, Size and Modified date.

Upload and download with the AWS CLI

These commands use the ibee profile from Using the S3 API. Replace WORKSPACE-ID with your endpoint’s ID.

# Upload one file to a key
aws s3 cp report.pdf s3://my-bucket/reports/2026-05.pdf \
--endpoint-url https://WORKSPACE-ID.blob.ibeestorage.com --profile ibee
# Upload a whole folder (only new or changed files)
aws s3 sync ./build/ s3://my-bucket/site/ \
--endpoint-url https://WORKSPACE-ID.blob.ibeestorage.com --profile ibee
# List one "folder"
aws s3 ls s3://my-bucket/reports/ \
--endpoint-url https://WORKSPACE-ID.blob.ibeestorage.com --profile ibee
# Download
aws s3 cp s3://my-bucket/reports/2026-05.pdf ./2026-05.pdf \
--endpoint-url https://WORKSPACE-ID.blob.ibeestorage.com --profile ibee
# Delete one file
aws s3 rm s3://my-bucket/reports/2026-05.pdf \
--endpoint-url https://WORKSPACE-ID.blob.ibeestorage.com --profile ibee

The AWS CLI and SDKs switch to a multipart upload — sending a big file in parts, in parallel — for large files. You don’t need to do anything; just remember the limits of 10,000 parts of up to 5 GiB each.

To set the content type a browser sees (for example for website files), add --content-type "text/html" to aws s3 cp.

Folders

Create one in the portal with Create Folder: enter a Folder Name (placeholder my-folder) of letters, numbers, hyphens and underscores, and click Create Folder. It’s created inside the folder you have open.

Behind the scenes a folder is an empty object whose key ends in /. With S3 tools you don’t need to create folders first: uploading to photos/2026/beach.jpg makes photos/ and photos/2026/ appear.

Download, view and share

  • Download: click the download icon on the object’s row.
  • Details: click the object’s name to see its Name, Size, Type, Modified date and Access (Public or Private). Images show a Preview.
  • Public link: in a public bucket with a Public Access URL, the details show the object’s Public Development URL, with a copy button. It’s rate-limited and meant for testing; use a custom domain for production.
  • Private link: create a presigned URL.

Delete objects

Deleted objects can’t be recovered unless the bucket was created with Object Lock (which keeps versions). Check before you delete.

  • One file: click the delete icon on its row and confirm.
  • Several files: tick their boxes, click Delete in the toolbar (it shows how many are selected), and confirm. Clear selection cancels.
  • Everything: use Empty bucket, or aws s3 rm s3://my-bucket --recursive for buckets with Object Lock or versioning.

Objects under a legal hold or retention period can’t be deleted; see Object Locking.

Verify

  • The portal list shows the file with the expected Size.
  • aws s3 ls s3://my-bucket/reports/ … lists the key.
  • aws s3api head-object --bucket my-bucket --key reports/2026-05.pdf … prints its ContentLength, ContentType and ETag (a fingerprint of the content).

Limits

Value
Portal upload300 MB per file
One S3 request (PutObject)5 GiB
Multipart uploadUp to 10,000 parts, each up to 5 GiB
Key length1,024 bytes of UTF-8
Folder name in the portalLetters, numbers, hyphens, underscores; no /
Keys per bulk delete (DeleteObjects)1,000

Troubleshooting

You seeWhat it meansWhat to do
No Upload or Create Folder buttonsYou’re on the bucket list, or you don’t have write accessOpen a bucket; ask an admin for write access.
Files larger than 300 MB must be uploaded via the API.Portal limitUse the AWS CLI, rclone or an SDK.
Folder name can only contain letters, numbers, hyphens, and underscoresThe folder name has spaces or symbolsUse a name like invoices_2026.
A folder with this name already existsSame name in this folderPick another name.
Cannot delete: object has legal hold or Cannot delete: object has retention lock on the delete icon, or Cannot delete “NAME”. This object is protected.The object is under a legal hold or retention periodRemove the legal hold, or wait until the retention date. See Object Locking.
Downloads are unavailable while this organization is suspended.Your organization is suspendedResolve the suspension under Billing, or contact support.
A file you uploaded doesn’t appearThe list hasn’t refreshed, or it went to a different key or bucketRefresh; check the full key, which is case-sensitive.
403 AccessDenied from the CLI on uploadThe credential is read-only or limited to other bucketsUse an Object Read & Write credential for this bucket.