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
        • Object Locking
        • Presigned URLs
      • 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
  • Enable Object Lock at bucket creation
  • Lock Settings tab
  • If Object Lock was enabled at creation
  • If Object Lock was not enabled at creation
  • How retention works
  • Best practices
  • Related
InfrastructureObject StorageObjects

Object Locking

Was this page helpful?
Edit this page
Previous

Presigned URLs

Next
Built with

Object Lock prevents objects from being deleted or overwritten while a retention period is in effect. Use it for compliance (financial records, audit logs), ransomware protection, or any case where data integrity must be guaranteed.

Object Lock is a permanent bucket setting. It must be enabled at bucket creation time under Advanced options in the Create Bucket dialog. It cannot be enabled, disabled, or changed after the bucket is created.

Enable Object Lock at bucket creation

When creating a bucket, expand Advanced options in the Create Bucket dialog and enable Object Lock before clicking Create Bucket. See Buckets → Create a bucket.

After creation, the Lock Settings tab will be active for the bucket and you can configure retention.

Lock Settings tab

After bucket creation, find the lock state in two places:

  • The General tab shows Object Lock as a read-only field (Enabled or Disabled).
  • The Lock Settings tab shows the active retention configuration.

If Object Lock was enabled at creation

The Lock Settings tab lets you manage retention policies for objects in the bucket. Object Lock applies to objects uploaded after retention is configured.

If Object Lock was not enabled at creation

The Lock Settings tab shows the message:

“Object Lock Not Enabled — Object locking must be enabled when creating the bucket to use retention policies. This setting cannot be changed after bucket creation.”

The message is marked Permanent Bucket Setting. To use Object Lock for that workload, create a new bucket with the option turned on and migrate objects.

How retention works

A locked object cannot be overwritten or deleted — not even by an Admin token — until the retention period expires. Use Object Lock together with API token scoping (Bucket policies) so that no path can bypass the lock.

Best practices

  • Decide at creation time. Because Object Lock cannot be added later, plan before creating buckets that may need immutability.
  • Pair with lifecycle rules carefully. Lifecycle expiry cannot delete locked objects; verify rules don’t silently fail on protected data.
  • Document your retention policy internally so future engineers understand why objects can’t be deleted.
  • Don’t lock everything. Reserve Object Lock for buckets where immutability is genuinely required.

Related

  • Buckets
  • Bucket policies
  • Lifecycle
  • Concepts