aws-sdk-go

Last updated Apr 21, 2026 You must generate an Access Key before getting started. All examples will utilize access_key_id and access_key_secret variables which represent the Access Key ID and Secret Access Key values you generated.

This example uses version 2 of the aws-sdk-go ↗︎ package. You must pass in the R2 configuration credentials when instantiating your S3 service client:

package main

import (
    "context"
    "encoding/json"
    "fmt"
    "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"
    "log"
)

func main() {
    var bucketName = "sdk-example"
    // Provide your Cloudflare account ID
    var accountId = "<ACCOUNT_ID>"
    // Retrieve your S3 API credentials for your R2 bucket via API tokens
    // (see: https://developers.cloudflare.com/r2/api/tokens)
    var accessKeyId = "<ACCESS_KEY_ID>"
    var accessKeySecret = "<SECRET_ACCESS_KEY>"

    cfg, err := config.LoadDefaultConfig(context.TODO(),
        config.WithCredentialsProvider(credentials.NewStaticCredentialsProvider(accessKeyId, accessKeySecret, "")),
        config.WithRegion("auto"), // Required by SDK but not used by R2
    )
    if err != nil {
        log.Fatal(err)
    }

    client := s3.NewFromConfig(cfg, func(o *s3.Options) {
            o.BaseEndpoint = aws.String(fmt.Sprintf("https://%s.r2.cloudflarestorage.com", accountId))
    })

    listObjectsOutput, err := client.ListObjectsV2(context.TODO(), &s3.ListObjectsV2Input{
        Bucket: &bucketName,
    })
    if err != nil {
        log.Fatal(err)
    }

    for _, object := range listObjectsOutput.Contents {
        obj, _ := json.MarshalIndent(object, "", "\t")
        fmt.Println(string(obj))
    }

    //  {
    //      "ChecksumAlgorithm": null,
    //      "ETag": "\"eb2b891dc67b81755d2b726d9110af16\"",
    //      "Key": "ferriswasm.png",
    //      "LastModified": "2022-05-18T17:20:21.67Z",
    //      "Owner": null,
    //      "Size": 87671,
    //      "StorageClass": "STANDARD"
    //  }

    listBucketsOutput, err := client.ListBuckets(context.TODO(), &s3.ListBucketsInput{})
    if err != nil {
        log.Fatal(err)
    }

    for _, object := range listBucketsOutput.Buckets {
        obj, _ := json.MarshalIndent(object, "", "\t")
        fmt.Println(string(obj))
    }

    // {
    //      "CreationDate": "2022-05-18T17:19:59.645Z",
    //      "Name": "sdk-example"
    // }
}

Generate presigned URLs

You can also generate presigned links that can be used to temporarily share public write access to a bucket.

presignClient := s3.NewPresignClient(client)

    presignResult, err := presignClient.PresignPutObject(context.TODO(), &s3.PutObjectInput{
        Bucket: aws.String(bucketName),
        Key:    aws.String("example.txt"),
    })

    if err != nil {
        panic("Couldn't get presigned URL for PutObject")
    }

    fmt.Printf("Presigned URL For object: %s\n", presignResult.URL)

Was this helpful?

YesNo

On this page

aws-sdk-go - 图1Docs

{"@context":"https://schema.org","@type":"TechArticle","@id":"https://developers.cloudflare.com/r2/examples/aws/aws-sdk-go/#page","headline":"aws-sdk-go","description":"Configure aws-sdk-go (v2) to work with Cloudflare R2 object storage.","url":"https://developers.cloudflare.com/r2/examples/aws/aws-sdk-go/","inLanguage":"en","image":"https://developers.cloudflare.com/r2/examples/aws/aws-sdk-go/og.png?v=42fb4d4435253e89","dateModified":"2026-04-21","publisher":{"@type":"Organization","name":"Cloudflare","description":"One platform for your apps, agents, and workforce. Build, secure, and scale without managing infrastructure","url":"https://www.cloudflare.com/","sameAs":["https://github.com/cloudflare","https://www.linkedin.com/company/cloudflare","https://x.com/cloudflare"],"logo":{"@type":"ImageObject","url":"https://developers.cloudflare.com/logo.svg"},"address":{"@type":"PostalAddress","streetAddress":"101 Townsend St","addressLocality":"San Francisco","addressRegion":"CA","postalCode":"94107","addressCountry":"US"},"contactPoint":[{"@type":"ContactPoint","contactType":"Customer Support","url":"https://support.cloudflare.com/","availableLanguage":["English"]},{"@type":"ContactPoint","contactType":"Sales","url":"https://www.cloudflare.com/contact/","availableLanguage":["English"]}]},"isPartOf":{"@type":"WebSite","@id":"https://developers.cloudflare.com/#website","name":"Cloudflare Docs","url":"https://developers.cloudflare.com/"}}

description: Configure the AWS SDK for Java v2 to work with Cloudflare R2 object storage. title: aws-sdk-java image: https://developers.cloudflare.com/r2/examples/aws/aws-sdk-java/og.png?v=395a2c91bdeaac0f

Skip to content

Documentation Index
Fetch the complete documentation index at: https://developers.cloudflare.com/r2/llms.txt
Use this file to discover all available pages before exploring further.