S3-Compatible API

Python (boto3)

import boto3

s3 = boto3.client(
    "s3",
    endpoint_url="https://object.us-east-2.rumble.cloud",
    aws_access_key_id="YOUR_ACCESS_KEY",
    aws_secret_access_key="YOUR_SECRET_KEY",
)

# List buckets
for bucket in s3.list_buckets()["Buckets"]:
    print(bucket["Name"])

# Upload a file
s3.upload_file("local-file.txt", "my-bucket", "remote-file.txt")

# Download a file
s3.download_file("my-bucket", "remote-file.txt", "downloaded.txt")

# Generate a presigned URL (valid 1 hour)
url = s3.generate_presigned_url(
    "get_object",
    Params={"Bucket": "my-bucket", "Key": "remote-file.txt"},
    ExpiresIn=3600,
)
print(url)

AWS CLI

# Configure a named profile
aws configure set aws_access_key_id YOUR_ACCESS_KEY --profile rumble
aws configure set aws_secret_access_key YOUR_SECRET_KEY --profile rumble
aws configure set region us-east-1 --profile rumble
aws configure set endpoint_url https://object.us-east-1.rumble.cloud --profile rumble

# List buckets
aws s3 ls --profile rumble

# Create a bucket
aws s3 mb s3://my-bucket --profile rumble

# Upload a file
aws s3 cp local-file.txt s3://my-bucket/ --profile rumble

# Sync a directory
aws s3 sync ./local-dir s3://my-bucket/prefix/ --profile rumble

# Delete a bucket and all contents
aws s3 rb s3://my-bucket --force --profile rumble

s3cmd

# Configure s3cmd (use the downloaded .cfg or configure manually)
# ~/.s3cfg or pass -c /path/to/config.cfg

[default]
access_key = YOUR_ACCESS_KEY
secret_key = YOUR_SECRET_KEY
host_base = object.us-east-2.rumble.cloud
host_bucket = object.us-east-2.rumble.cloud
use_https = True

# List buckets
s3cmd ls

# Create a bucket
s3cmd mb s3://my-bucket

# Upload a file
s3cmd put local-file.txt s3://my-bucket/

# Download a file
s3cmd get s3://my-bucket/remote-file.txt ./downloaded.txt

# Set CORS (XML only)
s3cmd setcors cors-policy.xml s3://my-bucket

Go (aws-sdk-go-v2)

package main

import (
	"context"
	"fmt"
	"log"

	"github.com/aws/aws-sdk-go-v2/aws"
	"github.com/aws/aws-sdk-go-v2/config"
	"github.com/aws/aws-sdk-go-v2/credentials"
	"github.com/aws/aws-sdk-go-v2/service/s3"
)

func main() {
	cfg, err := config.LoadDefaultConfig(context.TODO(),
		config.WithRegion("us-east-1"),
		config.WithCredentialsProvider(credentials.NewStaticCredentialsProvider(
			"YOUR_ACCESS_KEY",
			"YOUR_SECRET_KEY",
			"",
		)),
	)
	if err != nil {
		log.Fatal(err)
	}

	client := s3.NewFromConfig(cfg, func(o *s3.Options) {
		o.BaseEndpoint = aws.String("https://object.us-east-1.rumble.cloud")
		o.UsePathStyle = true
	})

	out, err := client.ListBuckets(context.TODO(), &s3.ListBucketsInput{})
	if err != nil {
		log.Fatal(err)
	}
	for _, b := range out.Buckets {
		fmt.Println(*b.Name)
	}
}

UsePathStyle: true is required; virtual-hosted-style bucket addressing is not supported.

Buckets

Objects

Multipart

CORS

Versioning

Lifecycle

Events

Policies

Tagging

Query

Encryption