Create Buckets
Create CoreWeave AI Object Storage buckets with Cloud Console or CLI clients.
Buckets are the primary organizational unit used to store object data in CoreWeave AI Object Storage. They are similar to folders in a file system.
This guide explains how to create a bucket with the CoreWeave Cloud Console or CLI clients such as S3cmd, AWS CLI, and Boto3.
Prerequisites
You must generate an Access Key before creating a bucket. When using the Cloud Console, use Cloud Console tokens to generate the Access Key. Workload Identity Federation is supported when using CLI clients.
Create a bucket with Cloud Console
- To create a bucket with the Cloud Console, you must have
admin
permissions. - Bucket names must be globally-unique and not begin with
cw-
orvip-
, which are reserved for internal use.
To create a bucket with the CoreWeave Cloud Console, follow these steps:
- In the Cloud Console, navigate to Object Storage > Buckets.
- Click Create Bucket.
- In the dialog, enter a Bucket Name.
- Chose a Zone.
- Click Create.
- Click More options to view information in Grafana, or to delete the bucket.
Create a bucket with CLI clients
CoreWeave AI Object Storage is compatible with S3-compatible clients.
Before creating a bucket, configure S3cmd, AWS CLI, or Boto3.
In the sections that follow:
- Replace
AVAILABILITY_ZONE
with a supported Availability Zone code. - Replace
BUCKET_NAME
with a globally unique name that does not begin withcw-
orvip-
, as these prefixes are reserved for internal use.
Use S3cmd
To create a bucket with S3cmd, use the mb
(make bucket) subcommand. The --bucket-location
parameter is required.
$s3cmd mb --bucket-location=AVAILABILITY_ZONE s3://BUCKET_NAME
If you need to configure S3cmd for AI Object storage, see Manage buckets with S3cmd.
Use AWS CLI
To create a bucket with AWS CLI, use the aws s3api
command. The LocationConstraint
parameter is required.
$aws s3api create-bucket \--bucket BUCKET_NAME \--region AVAILABILITY_ZONE \--create-bucket-configuration LocationConstraint=AVAILABILITY_ZONE
If you need to install or configure AWS CLI for AI Object Storage, see Manage buckets with AWS CLI.
Use Boto3
To create a bucket with Boto3, use the create_bucket
method. The LocationConstraint
parameter is required.
response = client.create_bucket(Bucket='BUCKET_NAME',CreateBucketConfiguration={'LocationConstraint': 'AVAILABILITY_ZONE',},)print(response)
If you need to configure Boto3 for AI Object Storage, see Manage buckets with Boto3.
Next steps
After creating a bucket, set policies to control access, lifecycle, and auditing.