The MinIO Go Client SDK provides straightforward APIs to access any Amazon S3 compatible object storage.

This Quickstart Guide covers how to install the MinIO client SDK, connect to MinIO, and create a sample file uploader. For a complete list of APIs and examples, see the godoc documentation or Go Client API Reference.

These examples presume a working Go development environment and the MinIO mc command line tool.

From your project directory:

go get github.com/minio/minio-go/v7

The MinIO client requires the following parameters to connect to an Amazon S3 compatible object storage:

package main
import (
	"log"
	"github.com/minio/minio-go/v7"
	"github.com/minio/minio-go/v7/pkg/credentials"
)
func main() {
	endpoint := "play.min.io"
	accessKeyID := "Q3AM3UQ867SPQQA43P2F"
	secretAccessKey := "zuf+tfteSlswRu7BJ86wekitnifILbZam1KYY3TG"
	useSSL := true
	// Initialize minio client object.
	minioClient, err := minio.New(endpoint, &minio.Options{
		Creds: credentials.NewStaticV4(accessKeyID, secretAccessKey, ""),
		Secure: useSSL,
	})
	if err != nil {
		log.Fatalln(err)
	}
	log.Printf("%#v\n", minioClient) // minioClient is now set up
}

This sample code connects to an object storage server, creates a bucket, and uploads a file to the bucket. It uses the MinIO play server, a public MinIO cluster located at https://play.min.io.

The play server runs the latest stable version of MinIO and may be used for testing and development. The access credentials shown in this example are open to the public and all data uploaded to play should be considered public and non-protected.

This example does the following:

• Connects to the MinIO play server using the provided credentials.

• Creates a bucket named testbucket.

• Uploads a file named testdata from /tmp.

• Verifies the file was created using mc ls.

  // FileUploader.go MinIO example
  package main
  import (
  	"context"
  	"log"
  	"github.com/minio/minio-go/v7"
  	"github.com/minio/minio-go/v7/pkg/credentials"
  )
  func main() {
  	ctx := context.Background()
  	endpoint := "play.min.io"
  	accessKeyID := "Q3AM3UQ867SPQQA43P2F"
  	secretAccessKey := "zuf+tfteSlswRu7BJ86wekitnifILbZam1KYY3TG"
  	useSSL := true
  	// Initialize minio client object.
  	minioClient, err := minio.New(endpoint, &minio.Options{
  		Creds: credentials.NewStaticV4(accessKeyID, secretAccessKey, ""),
  		Secure: useSSL,
  	})
  	if err != nil {
  		log.Fatalln(err)
  	}
  	// Make a new bucket called testbucket.
  	bucketName := "testbucket"
  	location := "us-east-1"
  	err = minioClient.MakeBucket(ctx, bucketName, minio.MakeBucketOptions{Region: location})
  	if err != nil {
  		// Check to see if we already own this bucket (which happens if you run this twice)
  		exists, errBucketExists := minioClient.BucketExists(ctx, bucketName)
  		if errBucketExists == nil && exists {
  			log.Printf("We already own %s\n", bucketName)
  		} else {
  			log.Fatalln(err)
  		}
  	} else {
  		log.Printf("Successfully created %s\n", bucketName)
  	}
  	// Upload the test file
  	// Change the value of filePath if the file is in another location
  	objectName := "testdata"
  	filePath := "/tmp/testdata"
  	contentType := "application/octet-stream"
  	// Upload the test file with FPutObject
  	info, err := minioClient.FPutObject(ctx, bucketName, objectName, filePath, minio.PutObjectOptions{ContentType: contentType})
  	if err != nil {
  		log.Fatalln(err)
  	}
  	log.Printf("Successfully uploaded %s of size %d\n", objectName, info.Size)
  }

1. Create a test file containing data:

You can do this with dd on Linux or macOS systems:

dd if=/dev/urandom of=/tmp/testdata bs=2048 count=10

or fsutil on Windows:

fsutil file createnew "C:\Users\<username>\Desktop\sample.txt" 20480

2. Run FileUploader with the following commands:

go mod init example/FileUploader
go get github.com/minio/minio-go/v7
go get github.com/minio/minio-go/v7/pkg/credentials
go run FileUploader.go

The output resembles the following:

2023年11月01日 14:27:55 Successfully created testbucket
2023年11月01日 14:27:55 Successfully uploaded testdata of size 20480

3. Verify the Uploaded File With mc ls:

mc ls play/testbucket
[2023年11月01日 14:27:55 UTC] 20KiB STANDARD TestDataFile

The full API Reference is available here.

• Complete API Reference

• MakeBucket
• ListBuckets
• BucketExists
• RemoveBucket
• ListObjects
• ListIncompleteUploads

• SetBucketPolicy
• GetBucketPolicy

• SetBucketNotification
• GetBucketNotification
• RemoveAllBucketNotification
• ListenBucketNotification (MinIO Extension)
• ListenNotification (MinIO Extension)

• FPutObject
• FGetObject

• GetObject
• PutObject
• PutObjectStreaming
• StatObject
• CopyObject
• RemoveObject
• RemoveObjects
• RemoveIncompleteUpload
• SelectObjectContent

• PresignedGetObject
• PresignedPutObject
• PresignedHeadObject
• PresignedPostPolicy

• SetAppInfo
• TraceOn
• TraceOff

• makebucket.go
• listbuckets.go
• bucketexists.go
• removebucket.go
• listobjects.go
• listobjectsV2.go
• listincompleteuploads.go

• setbucketpolicy.go
• getbucketpolicy.go
• listbucketpolicies.go

• setbucketlifecycle.go
• getbucketlifecycle.go

• setbucketencryption.go
• getbucketencryption.go
• removebucketencryption.go

• setbucketreplication.go
• getbucketreplication.go
• removebucketreplication.go

• setbucketnotification.go
• getbucketnotification.go
• removeallbucketnotification.go
• listenbucketnotification.go (MinIO Extension)
• listennotification.go (MinIO Extension)

• fputobject.go
• fgetobject.go

• putobject.go
• getobject.go
• statobject.go
• copyobject.go
• removeobject.go
• removeincompleteupload.go
• removeobjects.go

• put-encrypted-object.go
• get-encrypted-object.go
• fput-encrypted-object.go

• presignedgetobject.go
• presignedputobject.go
• presignedheadobject.go
• presignedpostpolicy.go

• Godoc Documentation
• Complete Documentation
• MinIO Go Client SDK API Reference

Contributors Guide

This SDK is distributed under the Apache License, Version 2.0, see LICENSE and NOTICE for more information.