---
title: "Bucket Management"
description: "Create and manage storage buckets on Edge Storage."
url: https://edge.network/docs/storage/buckets/
---

# Bucket Management

Storage

# Buckets

Buckets are containers for your objects. Each bucket has a unique name within your account.

## Bucket Naming Rules

- 3-63 characters long
- Lowercase letters, numbers, and hyphens only
- Must start and end with a letter or number
- Cannot contain consecutive hyphens
- Unique within your account

## Create a Bucket

### Via Control Panel

Navigate to [Storage → Buckets](https://account.edge.network/storage) and
click **Create Bucket**. Enter a name and click create.

### Via AWS CLI

```
$ aws --profile edge --endpoint-url https://storage.edge.network \
    s3 mb s3://my-new-bucket
```

### Via SDK (JavaScript)

```
import { S3Client, CreateBucketCommand } from '@aws-sdk/client-s3'

const client = new S3Client({
  endpoint: 'https://storage.edge.network',
  region: 'us-east-1',
  forcePathStyle: true,
  credentials: {
    accessKeyId: 'YOUR_ACCESS_KEY',
    secretAccessKey: 'YOUR_SECRET_KEY'
  }
})

await client.send(new CreateBucketCommand({
  Bucket: 'my-new-bucket'
}))
```

## List Buckets

```
$ aws --profile edge --endpoint-url https://storage.edge.network s3 ls

2025-01-15 09:00:00 assets
2025-02-01 14:30:00 backups
2025-02-10 11:15:00 uploads
```

## Delete a Bucket

A bucket must be empty before it can be deleted.

### Empty and delete:

```
# Delete all objects first
$ aws --profile edge --endpoint-url https://storage.edge.network \
    s3 rm s3://my-bucket --recursive

# Then delete the bucket
$ aws --profile edge --endpoint-url https://storage.edge.network \
    s3 rb s3://my-bucket
```

Warning

Bucket deletion is permanent and cannot be undone.

## Bucket Statistics

Each bucket tracks storage usage automatically:

| Metric | Description |
| `storage_bytes` | Total size of all objects in bytes |
| `object_count` | Number of objects in the bucket |
| `created_at` | When the bucket was created |

## Lifecycle Rules

Lifecycle rules automatically delete objects older than a specified number of days.
Useful for temporary uploads, log files, build artifacts, and session data.

### Creating a Rule

- Open a bucket and navigate to **Settings**
- Click **Add Rule**
- Set the number of days after which objects should be deleted
- Optionally set a **prefix filter** to only target objects with a specific path prefix (e.g. `logs/` or `tmp/`)

### How It Works

Rules are evaluated hourly. Objects whose last modified time exceeds the expiry threshold are deleted automatically.

Prefix filters let you target specific folders. A rule with prefix `logs/` only deletes objects under that path.

You can have multiple rules per bucket. For example: delete `tmp/` after 1 day and `logs/` after 30 days.

### API

`GET /api/storage/buckets/:name/lifecycle` — List rules for a bucket

`POST /api/storage/buckets/:name/lifecycle` — Create a rule ({ "expire_days": 30, "prefix": "logs/" })

`DELETE /api/storage/buckets/:name/lifecycle/:ruleId` — Delete a rule

## Public Buckets

Buckets can be made public, allowing anyone to access objects via a direct URL without authentication.

### Enabling Public Access

- Open a bucket and navigate to **Settings**
- Click **Make Public**
- Copy the public base URL

Objects are then accessible at:

```
https://storage.edge.network/_public/{customerId}/{bucket}/{object-key}
```

Public

GET and HEAD requests require no authentication. CORS headers are included for browser access.

Private (default)

All requests require S3 authentication or a presigned URL. This is the default for all new buckets.

CDN Recommended for Production

For production public content, consider using Edge CDN with a storage bucket origin instead. CDN provides caching, DDoS protection, and global edge delivery on top of public access.

### API

`PATCH /api/storage/buckets/:name/public` — Toggle public access ({ "is_public": true })

[Back to Docs](https://edge.network/docs) [Need help?](https://edge.network/support)