适用于与Amazon S3兼容云存储的Minio Go SDK

Minio Go Client SDK提供了简单的API来访问任何与Amazon S3兼容的对象存储服务。

支持的云存储:

• AWS Signature Version 4

  • Amazon S3
  • Minio

• AWS Signature Version 2

  • Google Cloud Storage (兼容模式)
  • Openstack Swift + Swift3 middleware
  • Ceph Object Gateway
  • Riak CS
    本文我们将学习如何安装Minio client SDK，连接到Minio，并提供一下文件上传的示例。对于完整的API以及示例，请参考Go Client API Reference。

本文假设你已经有 Go开发环境。

从Github下载

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

初始化Minio Client

Minio client需要以下4个参数来连接与Amazon S3兼容的对象存储。

package main
import (
    "github.com/minio/minio-go"
    "log"
)
func main() {
    endpoint := "play.minio.io:9000"
    accessKeyID := "Q3AM3UQ867SPQQA43P2F"
    secretAccessKey := "zuf+tfteSlswRu7BJ86wekitnifILbZam1KYY3TG"
    useSSL := true
    // 初使化 minio client对象。
    minioClient, err := minio.New(endpoint, accessKeyID, secretAccessKey, useSSL)
    if err != nil {
        log.Fatalln(err)
    }
    log.Printf("%#v\n", minioClient) // minioClient初使化成功
}

示例-文件上传

本示例连接到一个对象存储服务，创建一个存储桶并上传一个文件到存储桶中。

我们在本示例中使用运行在 https://play.minio.io:9000 上的Minio服务，你可以用这个服务来开发和测试。示例中的访问凭据是公开的。

FileUploader.go

package main
import (
    "github.com/minio/minio-go"
    "log"
)
func main() {
    endpoint := "play.minio.io:9000"
    accessKeyID := "Q3AM3UQ867SPQQA43P2F"
    secretAccessKey := "zuf+tfteSlswRu7BJ86wekitnifILbZam1KYY3TG"
    useSSL := true
    // 初使化minio client对象。
    minioClient, err := minio.New(endpoint, accessKeyID, secretAccessKey, useSSL)
    if err != nil {
        log.Fatalln(err)
    }
    // 创建一个叫mymusic的存储桶。
    bucketName := "mymusic"
    location := "us-east-1"
    err = minioClient.MakeBucket(bucketName, location)
    if err != nil {
        // 检查存储桶是否已经存在。
        exists, err := minioClient.BucketExists(bucketName)
        if err == nil && exists {
            log.Printf("We already own %s\n", bucketName)
        } else {
            log.Fatalln(err)
        }
    }
    log.Printf("Successfully created %s\n", bucketName)
    // 上传一个zip文件。
    objectName := "golden-oldies.zip"
    filePath := "/tmp/golden-oldies.zip"
    contentType := "application/zip"
    // 使用FPutObject上传一个zip文件。
    n, err := minioClient.FPutObject(bucketName, objectName, filePath, minio.PutObjectOptions{ContentType:contentType})
    if err != nil {
        log.Fatalln(err)
    }
    log.Printf("Successfully uploaded %s of size %d\n", objectName, n)
}

运行FileUploader

go run file-uploader.go
2016/08/13 17:03:28 Successfully created mymusic 
2016/08/13 17:03:40 Successfully uploaded golden-oldies.zip of size 16253413
mc ls play/mymusic/
[2016-05-27 16:02:16 PDT]  17MiB golden-oldies.zip

API文档

完整的API文档在这里。

• 完整API文档

  API文档 : 操作存储桶

• MakeBucket

• ListBuckets
• BucketExists
• RemoveBucket
• ListObjects
• ListObjectsV2

• ListIncompleteUploads

  API文档 : 存储桶策略

• SetBucketPolicy

• GetBucketPolicy

  API文档 : 存储桶通知

• SetBucketNotification

• GetBucketNotification
• RemoveAllBucketNotification

• ListenBucketNotification (Minio Extension)

  API文档 : 操作文件对象

• FPutObject

• FGetObject
• FPutObjectWithContext

• FGetObjectWithContext

  API文档 : 操作对象

• GetObject

• PutObject
• GetObjectWithContext
• PutObjectWithContext
• PutObjectStreaming
• StatObject
• CopyObject
• RemoveObject
• RemoveObjects

• RemoveIncompleteUpload

  API文档: 操作加密对象

• GetEncryptedObject

• PutEncryptedObject

  API文档 : Presigned操作

• PresignedGetObject

• PresignedPutObject
• PresignedHeadObject

• PresignedPostPolicy

  API文档 : 客户端自定义设置

• SetAppInfo

• SetCustomTransport
• TraceOn
• TraceOff

  完整示例

完整示例 : 操作存储桶

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

• listincompleteuploads.go

  完整示例 : 存储桶策略

• setbucketpolicy.go

• getbucketpolicy.go

• listbucketpolicies.go

  完整示例 : 存储桶通知

• setbucketnotification.go

• getbucketnotification.go
• removeallbucketnotification.go

• listenbucketnotification.go (Minio扩展)

  完整示例 : 操作文件对象

• fputobject.go

• fgetobject.go
• fputobject-context.go

• fgetobject-context.go

  完整示例 : 操作对象

• putobject.go

• getobject.go
• putobject-context.go
• getobject-context.go
• statobject.go
• copyobject.go
• removeobject.go
• removeincompleteupload.go

• removeobjects.go

  完整示例 : 操作加密对象

• put-encrypted-object.go

• get-encrypted-object.go

• fput-encrypted-object.go

  完整示例 : Presigned操作

• presignedgetobject.go

• presignedputobject.go
• presignedheadobject.go

• presignedpostpolicy.go

  了解更多

• 完整文档

• Minio Go Client SDK API文档
• Go 音乐播放器完整示例

  贡献

贡献指南

原文: https://docs.minio.io/cn/golang-client-quickstart-guide.html