Skip to main content

Buckets

Buckets are containers for your objects. Every object in Fil One lives inside a bucket.

Bucket naming rules​

Bucket names must be:

  • Between 3 and 63 characters
  • Lowercase letters, numbers, and hyphens only
  • Must start and end with a letter or number
  • Globally unique across all Fil One accounts

These are the same naming rules as AWS S3.

Creating a bucket​

note

Bucket creation and deletion must be done through the Fil One dashboard. The S3 API does not support CreateBucket or DeleteBucket — those operations return AccessDenied. All other S3 operations (uploading, downloading, listing objects, etc.) work normally via the API.

  1. From the dashboard, click Create Bucket.
  2. Enter a bucket name.
  3. Optionally create or configure an API key in the API key section.
  4. Click Create.

Every bucket is created with encryption enabled automatically.

Listing buckets​

aws s3 ls --endpoint-url https://eu-west-1.s3.fil.one

Deleting a bucket​

note

Bucket deletion is not yet supported. The dashboard has a delete button, but it is currently inactive. The S3 API also returns AccessDenied for DeleteBucket. This will be enabled in a future release.

Logical deletion and Filecoin storage

When you delete a bucket and its objects, the data is immediately removed from your Fil One account and is no longer accessible via the API or dashboard. However, the underlying Filecoin storage deals persist until their natural expiration, which can be up to 180 days. This is a property of the Filecoin network's sealed sector model and does not affect your ability to manage your data in Fil One.