For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
LoginGet Started
DocsAPI ReferenceChangelog
DocsAPI ReferenceChangelog
    • Home
  • Getting Started
  • Infrastructure
    • GPU VMs
    • Cloud VMs
    • Object Storage
      • Core Concepts
      • Upload Your First Object
      • Buckets
      • Objects
      • Mount a Bucket as a Filesystem
      • Metrics
      • API Tokens
      • Static Site Hosting
      • CDN integration
      • Pricing
      • Limits
    • Block Storage
  • Network & Security
    • Load Balancer
    • DNS
    • CDN
    • Firewalls
    • SSL Certificates
  • Tools
    • Backups
    • Snapshots
    • ISOs
    • SSH Keys
    • API Tokens
    • Secret Manager
    • Container Registry
  • Platform Fundamentals
    • Projects and tenancy model
    • IAM
    • Networking overview
    • Billing and usage
    • Limits and quotas
    • SLA and reliability
  • Tutorials
    • Deploy a web app
    • Host a static website with object storage
    • Run an AI model on a GPU VM
    • Set up a load-balanced architecture
    • Backup and disaster recovery
    • Multi-region deployment
  • Migration Guides
    • Migrate from AWS
    • Migrate from GCP
    • Migrate from Vultr and Linode
    • Move S3 workloads to IBEE Object Storage
    • VM image migration
  • Reference
    • Pricing
    • Regions
    • Limits
    • Error codes
    • Service level agreement
  • Support
    • Contact Support
    • Create a request
    • Troubleshooting guides
    • Visit ibee.ai
LogoLogo
LoginGet Started
On this page
  • Before you begin
  • 1. Create a bucket
  • 2. Upload an object from the portal
  • 3. Create API credentials
  • 4. Upload from the AWS CLI
  • Next steps
InfrastructureObject Storage

Upload Your First Object

Was this page helpful?
Edit this page
Previous

Buckets

Next
Built with

This guide walks through creating a bucket, generating API credentials, and uploading your first object — first from the portal, then from the AWS CLI.

Before you begin

  • An active IBEE Cloud project with a verified account
  • (Optional) The AWS CLI installed locally if you want to upload programmatically

1. Create a bucket

In the portal, click Object Storage in the left sidebar under Infrastructure, then click + Create Bucket at the top right of the Object Storage page.

Fill in the Create Bucket dialog:

FieldValue
Bucket Name3–63 characters, lowercase letters, numbers, and hyphens only (e.g. my-first-bucket).
LocationAutomatic (Asia Pacific) for the closest available region, or Specify jurisdiction to pin to a specific country.
Storage TypeStandard.
Advanced optionsOptional. Enable Object Lock here if you need immutability — it cannot be added later.

Click Create Bucket. A confirmation toast appears: “Bucket created successfully” and the bucket appears in the list.

See Buckets for the full create-bucket reference.

2. Upload an object from the portal

Click your new bucket from the Object Storage list to open it. The bucket page has three tabs: Objects, Metrics, Settings.

On the Objects tab, click Upload in the top right. Drag and drop a file onto the upload area, or click Select Files.

The uploaded object appears in the list with its Type, Storage Class, Size, and Modified date.

See Objects for full upload, download, and detail-page reference.

3. Create API credentials

For programmatic access you need an API token scoped to Object Storage.

In the portal sidebar, click API Tokens under Tools → + Create Token. Give the token a Name, check Object Storage, choose a permission level (e.g. Admin Read & Write), and pick Apply to all buckets in this project or Apply to specific buckets only.

Click Create Token and copy the credentials immediately — the Secret Access Key is shown only once:

CredentialUse
Bearer TokenThe IBEE REST API (ibee_v4_...)
Access Key IDS3-compatible tools (AKIA...)
Secret Access KeyS3-compatible tools — shown once, copy now

Your project’s S3 endpoint is https://{project_id}.blob.ibeestorage.com.

See API Tokens for rotation, scoping, and revoke.

4. Upload from the AWS CLI

Configure a profile with your credentials:

$aws configure --profile ibee
$# AWS Access Key ID: AKIA...
$# AWS Secret Access Key: <your-secret-access-key>
$# Default region: us-east-1
$# Default output: json

Upload an object:

$echo "hello, IBEE" > hello.txt
$
$aws --endpoint-url https://{project_id}.blob.ibeestorage.com \
> --profile ibee \
> s3 cp hello.txt s3://my-first-bucket/

Verify and download:

$# List
$aws --endpoint-url https://{project_id}.blob.ibeestorage.com \
> --profile ibee \
> s3 ls s3://my-first-bucket/
$
$# Download
$aws --endpoint-url https://{project_id}.blob.ibeestorage.com \
> --profile ibee \
> s3 cp s3://my-first-bucket/hello.txt ./hello-copy.txt

Next steps

Bucket Policies

Make a bucket public, scope access by API token.

Lifecycle Management

Automate object expiry and storage-class transitions.

Presigned URLs

Share time-limited links for upload or download.

Mount a Bucket as a Filesystem

Use a bucket like a local directory with s3fs or rclone.