starkandwayne/minio-go

Name: minio-go

Owner: Stark & Wayne

Description: Minio Go Library for Amazon S3 compatible cloud storage

Created: 2016-05-22 17:47:19.0

Updated: 2016-05-22 17:47:20.0

Pushed: 2016-05-24 22:28:56.0

Homepage: http://minio.io/download/#minio-sdk

Size: 3540

Language: Go

GitHub Committers

User	Most Recent Commit	# Commits

Other Committers

User	Email	Most Recent Commit	# Commits

README

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.

 get github.com/minio/minio-go

Example

ListBuckets()

This example shows how to List your buckets.

age main

rt (
"log"

"github.com/minio/minio-go"


 main() {
// Requests are always secure (HTTPS) by default. Set secure=false 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.
secure := true // Defaults to HTTPS requests.
s3Client, err := minio.New("s3.amazonaws.com", "YOUR-ACCESS-KEY-HERE", "YOUR-SECRET-KEY-HERE", secure)
if err != nil {
    log.Fatalln(err)
}
buckets, err := s3Client.ListBuckets()
if err != nil {
    log.Fatalln(err)
}
for _, bucket := range buckets {
    log.Println(bucket)
}

Documentation

API documentation

Examples

Bucket Operations.

• MakeBucket(bucketName, location) error
• BucketExists(bucketName) error
• RemoveBucket(bucketName) error
• ListBuckets() []BucketInfo
• ListObjects(bucketName, objectPrefix, recursive, chan<- struct{}) <-chan ObjectInfo
• ListIncompleteUploads(bucketName, prefix, recursive, chan<- struct{}) <-chan ObjectMultipartInfo

Object Operations.

• PutObject(bucketName, objectName, io.Reader, contentType) error
• GetObject(bucketName, objectName) (*Object, error)
• StatObject(bucketName, objectName) (ObjectInfo, error)
• RemoveObject(bucketName, objectName) error
• RemoveIncompleteUpload(bucketName, objectName) <-chan error

File Object Operations.

• FPutObject(bucketName, objectName, filePath, contentType) (size, error)
• FGetObject(bucketName, objectName, filePath) error

Presigned Operations.

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

Bucket Policy Operations.

• SetBucketPolicy(bucketName, objectPrefix, BucketPolicy) error
• GetBucketPolicy(bucketName, objectPrefix) (BucketPolicy, error)
• RemoveBucketPolicy(bucketName, objectPrefix) error

API Reference

Contribute

Contributors Guide