Minio Go Library for Amazon S3 Compatible Cloud Storage

Description

Minio Go library is a simple client library for S3 compatible cloud storage servers. Supports AWS Signature Version 4 and 2. AWS Signature Version 4 is chosen as default.

List of supported cloud storage providers.

• AWS Signature Version 4

  • Amazon S3
  • Minio

• AWS Signature Version 2

  • Google Cloud Storage (Compatibility Mode)
  • Openstack Swift + Swift3 middleware
  • Ceph Object Gateway
  • Riak CS

Install

If you do not have a working Golang environment, please follow Install Golang.

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

Example

ListBuckets()

This example shows how to List your buckets.

package main

import (
	"log"

	"github.com/minio/minio-go"
)

func main() {
	// Requests are always secure (HTTPS) by default. Set insecure=true to enable insecure (HTTP) access.
	// This boolean value is the last argument for New().

	// New returns an Amazon S3 compatible client object. API copatibality (v2 or v4) is automatically
	// determined based on the Endpoint value.
	s3Client, err := minio.New("s3.amazonaws.com", "YOUR-ACCESS-KEY-HERE", "YOUR-SECRET-KEY-HERE", false)
	if err != nil {
	    log.Fatalln(err)
	}
	for bucket := range s3Client.ListBuckets() {
		if bucket.Err != nil {
			log.Fatalln(bucket.Err)
		}
		log.Println(bucket)
	}
}

Documentation

Bucket Operations.

• MakeBucket(bucketName, BucketACL) error
• BucketExists(bucketName) error
• RemoveBucket(bucketName) error
• GetBucketACL(bucketName) (BucketACL, error)
• SetBucketACL(bucketName, BucketACL) error)
• ListBuckets() <-chan BucketStat
• ListObjects(bucketName, objectPrefix, recursive) <-chan ObjectStat
• ListIncompleteUploads(bucketName, prefix, recursive) <-chan ObjectMultipartStat

Object Operations.

• PutObject(bucketName, objectName, contentType, io.ReadSeeker) error
• GetObject(bucketName, objectName) (io.ReadSeeker, error)
• GetPartialObject(bucketName, objectName, offset, length) (io.ReadSeeker, error)
• StatObject(bucketName, objectName) (ObjectStat, error)
• RemoveObject(bucketName, objectName) error
• RemoveIncompleteUpload(bucketName, objectName) <-chan error

Presigned Operations.

• PresignedGetObject(bucketName, objectName, time.Duration) (string, error)
• PresignedPutObject(bucketName, objectName, time.Duration) (string, error)
• PresignedPostPolicy(NewPostPolicy()) (map[string]string, error)

API Reference

Contribute

Contributors Guide