🚀 Get 25% off access to all my premium courses - use discount code FUNCMAIN at checkout - view the pricing page now!


Listing Buckets within our S3 Account

March 19, 2018

Course Instructor: Elliot Forbes

Hey Gophers! My name is Elliot and I'm the creator of TutorialEdge and I've been working with Go systems for roughly 5 years now.

Twitter: @Elliot_f

Now that we’ve covered at a very high level what the S3 service does, let’s dive in and start writing code that will allow us to list the S3 buckets available to us!

Credential Management

Note - You will need to configure your aws credentials before this will work. You can find out more information on how to do that here: Configuration Basics

Let’s start off by creating a new main.go file in which we’ll work:

package main

import "fmt"

func main() {
	fmt.Println("Listing Buckets")

We’ll also want to ensure that we have go modules enabled within our project directory so that when we build or run our app, it can fetch the AWS SDK package.

$ go mod init github.com/TutorialEdge/go-aws-s3-course

I’ve done this at the root of my project directory so that I can reuse the modules through all of the videos.

Creating an S3 Client

Let’s start off by creating an S3 Client which will allow us to interact with the S3 service:

package main

import (


func main() {
	fmt.Println("Listing Buckets")

	sess, err := session.NewSession(&aws.Config{
		Region: aws.String("us-west-2")},
	if err != nil {

	// Create S3 service client
	svc := s3.New(sess)

With this in place, let’s now try and use this to list some of the buckets within our account:

result, err := svc.ListBuckets(nil)
if err != nil {
  log.Fatalf("Unable to list buckets, %v", err)


for _, b := range result.Buckets {
  fmt.Printf("* %s created on %s\n",
    aws.StringValue(b.Name), aws.TimeValue(b.CreationDate))