Managing Buckets

Buckets are created and managed through the Crusoe Cloud Console or CLI. They cannot be created or deleted through S3 client tools.

Bucket names must comply with the naming rules described in the Overview, including being globally unique across a Crusoe Cloud region and between 3–63 characters using only lowercase letters, numbers, and hyphens.

By default the buckets are only accessible by bucket owner via up to 2 Object Storage API keys.

Creating a Bucket

CLI

crusoe storage buckets create \
  --name my-training-data \
  --location us-east1-a

--name and --location are required. The bucket must be in the same location as the VMs that will access it.

UI

1. Visit the Crusoe Cloud Console.
2. Navigate to Storage > Buckets in the left navigation.
3. Click Create Bucket.
4. Enter a name for the bucket.
5. Select the location.
6. (Optional)Enable versioning and object lock if desired.
7. Click Create.

Terraform

info

Terraform support for Object Storage bucket management is coming soon. In the meantime, use the CLI or Console to create and manage buckets.

Listing Buckets

CLI

crusoe storage buckets list

Optional filters:

• --location <location> — Filter by location.
• --tag key=<key>,value=<value> — Filter by tag.

UI

1. Navigate to Storage > Buckets in the Console.
2. All buckets in your project are listed with their name, location, size, and creation date.

Terraform

info

Terraform support for Object Storage bucket management is coming soon. In the meantime, use the CLI or Console to list buckets.

Getting Bucket Details

CLI

crusoe storage buckets get my-training-data

This returns the bucket's metadata including versioning state, object lock configuration, tags, and used capacity.

UI

1. Navigate to Storage > Buckets in the Console.
2. Click on a bucket name to view its details, including the S3 endpoint, Bucket URL, versioning state, object lock configuration, tags, and current size.

Terraform

info

Terraform support for Object Storage bucket management is coming soon. In the meantime, use the CLI or Console to view bucket details.

Managing Bucket Tags

CLI

Add tags:

crusoe storage buckets add-tags my-training-data \
  --tag key=environment,value=production \
  --tag key=team,value=ml-infra

Remove tags:

crusoe storage buckets remove-tags my-training-data \
  --tag key=environment,value=production

List tags:

crusoe storage buckets list-tags my-training-data

UI

1. Visit the Crusoe Cloud Console.
2. Navigate to Storage > Buckets in the left navigation.
3. Click on the bucket for which you want to add tags.
4. Click on the Edit Bucket Details button.
5. Enter the key-value pairs in the Tags section.
6. Click Update.

Terraform

info

Terraform support for Object Storage bucket management is coming soon. In the meantime, use the CLI to manage bucket tags.

Enabling Versioning

Versioning preserves every version of every object in the bucket, protecting against accidental overwrites and deletions.

Warning

Once versioning is enabled, it cannot be disabled or suspended.

CLI

crusoe storage buckets enable-versioning my-training-data

UI

1. Visit the Crusoe Cloud Console.
2. Navigate to Storage > Buckets in the left navigation.
3. Click on the bucket for which you want to Enable Versioning.
4. Click on the Edit Bucket Details button.
5. Click on the Versioning radio button.
6. Click Update.

Terraform

info

Terraform support for Object Storage bucket management is coming soon. In the meantime, use the CLI to enable versioning.

Enabling Object Lock

Object lock protects objects from being deleted or overwritten for a specified retention period. Enabling object lock automatically enables versioning.

Warning

Once object lock is enabled on a bucket, it cannot be disabled, and versioning cannot be suspended.

CLI

crusoe storage buckets enable-locking my-training-data \
  --retention 30d

The --retention flag accepts values like 7d (7 days) or 1y (1 year).

UI

1. Visit the Crusoe Cloud Console.
2. Navigate to Storage > Buckets in the left navigation.
3. Click on the bucket for which you want to Enable Object Lock.
4. Click on the Versioning radio button.
5. Click on the Object Lock radio button.
6. Click Update.

Terraform

info

Terraform support for Object Storage bucket management is coming soon. In the meantime, use the CLI to enable object locking.

Deleting a Bucket

Warning

A bucket must be empty before it can be deleted. Deleting a bucket is a permanent action.

CLI

crusoe storage buckets delete --name my-training-data

UI

1. Navigate to Storage > Buckets in the Console.
2. Click the delete icon next to the bucket you wish to delete.
3. Enter the name of the bucket to confirm and click Delete

Terraform

info

Terraform support for Object Storage bucket management is coming soon. In the meantime, use the CLI or Console to delete buckets.