How to use DigitalOcean Spaces with the AWS S3 SDKs?

Question

DigitalOcean Spaces was designed to be inter-operable with the AWS S3 API in order allow users to continue using the tools they are already working with. In most cases, using Spaces with an existing S3 library requires configuring the endpoint value to be ${REGION}.digitaloceanspaces.com Though often how to change that setting is not well documented as examples tend to use the default AWS values. Third-party libraries tend to be better with this as they will support alternative, self-hosted object storage implementations like Mino or Ceph.

In the answers, let’s share some basic examples of working with Spaces using the AWS SDKs in various languages.

Andrew SB · Accepted Answer

PHP - (AWS docs ) <?php // Included aws/aws-sdk-php via Composer's autoloader // Installed with: composer.phar require aws/aws-sdk-php require 'vendor/autoload.php'; use Aws\S3\S3Client; // Configure a client using Spaces $client = new Aws\S3\S3Client([ 'version' => 'latest', 'region' => 'nyc3', 'endpoint' => 'https://nyc3.digitaloceanspaces.com', 'credentials' => [ 'key' => 'ACCESS_KEY', 'secret' => 'SECRET_KEY', ], ]); // Create a new Space $client->createBucket([ 'Bucket' => 'my-new-space-with-a-unique-name', ]); // Listing all Spaces in the region $spaces = $client->listBuckets(); foreach ($spaces['Buckets'] as $space){ echo $space['Name']."
"; } // Upload a file to the Space $insert = $client->putObject([ 'Bucket' => 'my-new-space-with-a-unique-name', 'Key' => 'file.ext', 'Body' => 'The contents of the file' ]);

sourceholder · Answer

Working C# example using Amazon AWSSDK (V2.x) . IAmazonS3 amazonS3Client = AWSClientFactory.CreateAmazonS3Client("your-spaces-key", "your-spaces-key-secrete", new AmazonS3Config { ServiceURL = "https://nyc3.digitaloceanspaces.com" } ); var myBuckets = amazonS3Client.ListBuckets();

Andrew SB · Answer

Go - (AWS Docs ) package main import ( "fmt" "strings" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/credentials" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/s3" ) func main() { // Initialize a client using Spaces s3Config := &aws.Config{ Credentials: credentials.NewStaticCredentials("ACCESS_KEY", "SECRET_KEY", ""), Endpoint: aws.String("https://nyc3.digitaloceanspaces.com"), Region: aws.String("us-east-1"), // This is counter intuitive, but it will fail with a non-AWS region name. } newSession := session.New(s3Config) s3Client := s3.New(newSession) // Create a new Space params := &s3.CreateBucketInput{ Bucket: aws.String("my-new-space-with-a-unique-name"), } _, err := s3Client.CreateBucket(params) if err != nil { fmt.Println(err.Error()) return } // List all Spaces in the region spaces, err := s3Client.ListBuckets(nil) if err != nil { fmt.Println(err.Error()) return } for _, b := range spaces.Buckets { fmt.Printf("%s
", aws.StringValue(b.Name)) } // Upload a file to the Space object := s3.PutObjectInput{ Body: strings.NewReader("The contents of the file"), Bucket: aws.String("my-new-space-with-a-unique-name"), Key: aws.String("file.ext"), } _, err = s3Client.PutObject(&object) if err != nil { fmt.Println(err.Error()) return } }

Become a contributor for community

DigitalOcean Documentation

Resources for startups and AI-native businesses

The developer cloud

Start building today

Report this

How to use DigitalOcean Spaces with the AWS S3 SDKs?

Related questions

Using local packages in serverless functions

How include shared packages when deploying functions

My app deployment wit go 1.24.1 is failing

How to change the console's background to white

MySQL connection timed out from Golang web app

Functions - Golang: cannot download modules

How to reference code in the lib folder for go functions

Hitting issues with deploying govips image compression with DO Functions

How to debug PIDPressure Issue

I've hosted a websocket service in my droplet, postman is able to connect to it via ip:port but not my local python app

App platform [Go App]: How to install `goose` package for migrations

Building Function written in Go times out. No visibility into cause.

Report this

How to use DigitalOcean Spaces with the AWS S3 SDKs?

Related questions

Using local packages in serverless functions

How include shared packages when deploying functions

My app deployment wit go 1.24.1 is failing

How to change the console's background to white

MySQL connection timed out from Golang web app

Functions - Golang: cannot download modules

How to reference code in the lib folder for go functions

Hitting issues with deploying govips image compression with DO Functions

How to debug PIDPressure Issue

I've hosted a websocket service in my droplet, postman is able to connect to it via ip:port but not my local python app

App platform [Go App]: How to install `goose` package for migrations

Building Function written in Go times out. No visibility into cause.