KurlesHS/restic
1
0
Fork 0
forked from TrueCloudLab/restic
Code Pull requests Activity
restic/vendor/github.com/minio/minio-go/v6/README.md

239 lines
12 KiB
Markdown
Raw Normal View History

Update vendored dependencies
2019-11-22 13:57:56 +00:00
# MinIO Go Client SDK for Amazon S3 Compatible Cloud Storage [![Slack](https://slack.min.io/slack?type=svg)](https://slack.min.io) [![Sourcegraph](https://sourcegraph.com/github.com/minio/minio-go/-/badge.svg)](https://sourcegraph.com/github.com/minio/minio-go?badge) [![Apache V2 License](http://img.shields.io/badge/license-Apache%20V2-blue.svg)](https://github.com/minio/minio-go/blob/master/LICENSE)
Vendor dependencies with dep
2017-07-23 12:24:45 +00:00
Update vendored dependencies
2019-11-22 13:57:56 +00:00
The MinIO Go Client SDK provides simple APIs to access any Amazon S3 compatible object storage.
Vendor dependencies with dep
2017-07-23 12:24:45 +00:00
Update vendored dependencies
2019-11-22 13:57:56 +00:00
This quickstart guide will show you how to install the MinIO client SDK, connect to MinIO, and provide a walkthrough for a simple file uploader. For a complete list of APIs and examples, please take a look at the [Go Client API Reference](https://docs.min.io/docs/golang-client-api-reference).
Vendor dependencies with dep
2017-07-23 12:24:45 +00:00
Update vendored dependencies
2019-11-22 13:57:56 +00:00
This document assumes that you have a working [Go development environment](https://golang.org/doc/install).
Vendor dependencies with dep
2017-07-23 12:24:45 +00:00
## Download from Github
```sh
Update vendored dependencies
2019-11-22 13:57:56 +00:00
GO111MODULE=on go get github.com/minio/minio-go/v6
Vendor dependencies with dep
2017-07-23 12:24:45 +00:00
```
Update vendored dependencies
2019-11-22 13:57:56 +00:00
## Initialize MinIO Client
MinIO client requires the following four parameters specified to connect to an Amazon S3 compatible object storage.
Vendor dependencies with dep
2017-07-23 12:24:45 +00:00
Update github.com/minio/minio-go Closes #1918
2018-09-25 12:43:32 +00:00
| Parameter | Description|
Vendor dependencies with dep
2017-07-23 12:24:45 +00:00
| :--- | :--- |
Update github.com/minio/minio-go Closes #1918
2018-09-25 12:43:32 +00:00
| endpoint | URL to object storage service. |
Vendor dependencies with dep
2017-07-23 12:24:45 +00:00
| accessKeyID | Access key is the user ID that uniquely identifies your account. |
| secretAccessKey | Secret key is the password to your account. |
| secure | Set this value to 'true' to enable secure (HTTPS) access. |
```go
package main
import (
Update vendored dependencies
2019-11-22 13:57:56 +00:00
"github.com/minio/minio-go/v6"
Vendor dependencies with dep
2017-07-23 12:24:45 +00:00
"log"
)
func main() {
Update vendored dependencies
2019-11-22 13:57:56 +00:00
endpoint := "play.min.io"
Vendor dependencies with dep
2017-07-23 12:24:45 +00:00
accessKeyID := "Q3AM3UQ867SPQQA43P2F"
secretAccessKey := "zuf+tfteSlswRu7BJ86wekitnifILbZam1KYY3TG"
useSSL := true
// Initialize minio client object.
minioClient, err := minio.New(endpoint, accessKeyID, secretAccessKey, useSSL)
if err != nil {
log.Fatalln(err)
}
Update dependencies
2017-09-13 12:09:48 +00:00
log.Printf("%#v\n", minioClient) // minioClient is now setup
Update minio-go
2017-12-08 19:45:59 +00:00
}
Vendor dependencies with dep
2017-07-23 12:24:45 +00:00
```
## Quick Start Example - File Uploader
This example program connects to an object storage server, creates a bucket and uploads a file to the bucket.
Update vendored dependencies
2019-11-22 13:57:56 +00:00
We will use the MinIO server running at [https://play.min.io](https://play.min.io) in this example. Feel free to use this service for testing and development. Access credentials shown in this example are open to the public.
Vendor dependencies with dep
2017-07-23 12:24:45 +00:00
### FileUploader.go
```go
package main
import (
Update vendored dependencies
2019-11-22 13:57:56 +00:00
"github.com/minio/minio-go/v6"
Vendor dependencies with dep
2017-07-23 12:24:45 +00:00
"log"
)
func main() {
Update vendored dependencies
2019-11-22 13:57:56 +00:00
endpoint := "play.min.io"
Vendor dependencies with dep
2017-07-23 12:24:45 +00:00
accessKeyID := "Q3AM3UQ867SPQQA43P2F"
secretAccessKey := "zuf+tfteSlswRu7BJ86wekitnifILbZam1KYY3TG"
useSSL := true
// Initialize minio client object.
minioClient, err := minio.New(endpoint, accessKeyID, secretAccessKey, useSSL)
if err != nil {
log.Fatalln(err)
}
// Make a new bucket called mymusic.
bucketName := "mymusic"
location := "us-east-1"
err = minioClient.MakeBucket(bucketName, location)
if err != nil {
// Check to see if we already own this bucket (which happens if you run this twice)
Update vendored dependencies
2019-11-22 13:57:56 +00:00
exists, errBucketExists := minioClient.BucketExists(bucketName)
if errBucketExists == nil && exists {
Vendor dependencies with dep
2017-07-23 12:24:45 +00:00
log.Printf("We already own %s\n", bucketName)
} else {
log.Fatalln(err)
}
Update dependencies Closes #2129
2019-01-27 20:07:57 +00:00
} else {
log.Printf("Successfully created %s\n", bucketName)
Vendor dependencies with dep
2017-07-23 12:24:45 +00:00
}
// Upload the zip file
objectName := "golden-oldies.zip"
filePath := "/tmp/golden-oldies.zip"
contentType := "application/zip"
// Upload the zip file with FPutObject
Update minio-go
2017-12-08 19:45:59 +00:00
n, err := minioClient.FPutObject(bucketName, objectName, filePath, minio.PutObjectOptions{ContentType:contentType})
Vendor dependencies with dep
2017-07-23 12:24:45 +00:00
if err != nil {
log.Fatalln(err)
}
log.Printf("Successfully uploaded %s of size %d\n", objectName, n)
}
```
### Run FileUploader
```sh
go run file-uploader.go
Update github.com/minio/minio-go Closes #1918
2018-09-25 12:43:32 +00:00
2016/08/13 17:03:28 Successfully created mymusic
Vendor dependencies with dep
2017-07-23 12:24:45 +00:00
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 Reference
Update github.com/minio/minio-go Closes #1918
2018-09-25 12:43:32 +00:00
The full API Reference is available here.
Vendor dependencies with dep
2017-07-23 12:24:45 +00:00
Update vendored dependencies
2019-11-22 13:57:56 +00:00
* [Complete API Reference](https://docs.min.io/docs/golang-client-api-reference)
Vendor dependencies with dep
2017-07-23 12:24:45 +00:00
### API Reference : Bucket Operations
Update vendored dependencies
2019-11-22 13:57:56 +00:00
* [`MakeBucket`](https://docs.min.io/docs/golang-client-api-reference#MakeBucket)
* [`ListBuckets`](https://docs.min.io/docs/golang-client-api-reference#ListBuckets)
* [`BucketExists`](https://docs.min.io/docs/golang-client-api-reference#BucketExists)
* [`RemoveBucket`](https://docs.min.io/docs/golang-client-api-reference#RemoveBucket)
* [`ListObjects`](https://docs.min.io/docs/golang-client-api-reference#ListObjects)
* [`ListObjectsV2`](https://docs.min.io/docs/golang-client-api-reference#ListObjectsV2)
* [`ListIncompleteUploads`](https://docs.min.io/docs/golang-client-api-reference#ListIncompleteUploads)
Vendor dependencies with dep
2017-07-23 12:24:45 +00:00
### API Reference : Bucket policy Operations
Update vendored dependencies
2019-11-22 13:57:56 +00:00
* [`SetBucketPolicy`](https://docs.min.io/docs/golang-client-api-reference#SetBucketPolicy)
* [`GetBucketPolicy`](https://docs.min.io/docs/golang-client-api-reference#GetBucketPolicy)
Vendor dependencies with dep
2017-07-23 12:24:45 +00:00
### API Reference : Bucket notification Operations
Update vendored dependencies
2019-11-22 13:57:56 +00:00
* [`SetBucketNotification`](https://docs.min.io/docs/golang-client-api-reference#SetBucketNotification)
* [`GetBucketNotification`](https://docs.min.io/docs/golang-client-api-reference#GetBucketNotification)
* [`RemoveAllBucketNotification`](https://docs.min.io/docs/golang-client-api-reference#RemoveAllBucketNotification)
* [`ListenBucketNotification`](https://docs.min.io/docs/golang-client-api-reference#ListenBucketNotification) (MinIO Extension)
Vendor dependencies with dep
2017-07-23 12:24:45 +00:00
### API Reference : File Object Operations
Update vendored dependencies
2019-11-22 13:57:56 +00:00
* [`FPutObject`](https://docs.min.io/docs/golang-client-api-reference#FPutObject)
* [`FGetObject`](https://docs.min.io/docs/golang-client-api-reference#FGetObject)
* [`FPutObjectWithContext`](https://docs.min.io/docs/golang-client-api-reference#FPutObjectWithContext)
* [`FGetObjectWithContext`](https://docs.min.io/docs/golang-client-api-reference#FGetObjectWithContext)
Vendor dependencies with dep
2017-07-23 12:24:45 +00:00
### API Reference : Object Operations
Update vendored dependencies
2019-11-22 13:57:56 +00:00
* [`GetObject`](https://docs.min.io/docs/golang-client-api-reference#GetObject)
* [`PutObject`](https://docs.min.io/docs/golang-client-api-reference#PutObject)
* [`GetObjectWithContext`](https://docs.min.io/docs/golang-client-api-reference#GetObjectWithContext)
* [`PutObjectWithContext`](https://docs.min.io/docs/golang-client-api-reference#PutObjectWithContext)
* [`PutObjectStreaming`](https://docs.min.io/docs/golang-client-api-reference#PutObjectStreaming)
* [`StatObject`](https://docs.min.io/docs/golang-client-api-reference#StatObject)
* [`CopyObject`](https://docs.min.io/docs/golang-client-api-reference#CopyObject)
* [`RemoveObject`](https://docs.min.io/docs/golang-client-api-reference#RemoveObject)
* [`RemoveObjects`](https://docs.min.io/docs/golang-client-api-reference#RemoveObjects)
* [`RemoveIncompleteUpload`](https://docs.min.io/docs/golang-client-api-reference#RemoveIncompleteUpload)
* [`SelectObjectContent`](https://docs.min.io/docs/golang-client-api-reference#SelectObjectContent)
Update github.com/minio/minio-go Closes #1918
2018-09-25 12:43:32 +00:00
Vendor dependencies with dep
2017-07-23 12:24:45 +00:00
### API Reference : Presigned Operations
Update vendored dependencies
2019-11-22 13:57:56 +00:00
* [`PresignedGetObject`](https://docs.min.io/docs/golang-client-api-reference#PresignedGetObject)
* [`PresignedPutObject`](https://docs.min.io/docs/golang-client-api-reference#PresignedPutObject)
* [`PresignedHeadObject`](https://docs.min.io/docs/golang-client-api-reference#PresignedHeadObject)
* [`PresignedPostPolicy`](https://docs.min.io/docs/golang-client-api-reference#PresignedPostPolicy)
Vendor dependencies with dep
2017-07-23 12:24:45 +00:00
### API Reference : Client custom settings
Update vendored dependencies
2019-11-22 13:57:56 +00:00
* [`SetAppInfo`](http://docs.min.io/docs/golang-client-api-reference#SetAppInfo)
* [`SetCustomTransport`](http://docs.min.io/docs/golang-client-api-reference#SetCustomTransport)
* [`TraceOn`](http://docs.min.io/docs/golang-client-api-reference#TraceOn)
* [`TraceOff`](http://docs.min.io/docs/golang-client-api-reference#TraceOff)
Vendor dependencies with dep
2017-07-23 12:24:45 +00:00
## Full Examples
Update dependencies
2017-09-13 12:09:48 +00:00
### Full Examples : Bucket Operations
Vendor dependencies with dep
2017-07-23 12:24:45 +00:00
* [makebucket.go](https://github.com/minio/minio-go/blob/master/examples/s3/makebucket.go)
* [listbuckets.go](https://github.com/minio/minio-go/blob/master/examples/s3/listbuckets.go)
* [bucketexists.go](https://github.com/minio/minio-go/blob/master/examples/s3/bucketexists.go)
* [removebucket.go](https://github.com/minio/minio-go/blob/master/examples/s3/removebucket.go)
* [listobjects.go](https://github.com/minio/minio-go/blob/master/examples/s3/listobjects.go)
* [listobjectsV2.go](https://github.com/minio/minio-go/blob/master/examples/s3/listobjectsV2.go)
* [listincompleteuploads.go](https://github.com/minio/minio-go/blob/master/examples/s3/listincompleteuploads.go)
Update dependencies
2017-09-13 12:09:48 +00:00
### Full Examples : Bucket policy Operations
Vendor dependencies with dep
2017-07-23 12:24:45 +00:00
* [setbucketpolicy.go](https://github.com/minio/minio-go/blob/master/examples/s3/setbucketpolicy.go)
* [getbucketpolicy.go](https://github.com/minio/minio-go/blob/master/examples/s3/getbucketpolicy.go)
* [listbucketpolicies.go](https://github.com/minio/minio-go/blob/master/examples/s3/listbucketpolicies.go)
Update github.com/minio/minio-go Closes #1918
2018-09-25 12:43:32 +00:00
Update dependencies
2018-09-03 18:23:56 +00:00
### Full Examples : Bucket lifecycle Operations
* [setbucketlifecycle.go](https://github.com/minio/minio-go/blob/master/examples/s3/setbucketlifecycle.go)
* [getbucketlifecycle.go](https://github.com/minio/minio-go/blob/master/examples/s3/getbucketlifecycle.go)
Update dependencies
2017-09-13 12:09:48 +00:00
### Full Examples : Bucket notification Operations
Vendor dependencies with dep
2017-07-23 12:24:45 +00:00
* [setbucketnotification.go](https://github.com/minio/minio-go/blob/master/examples/s3/setbucketnotification.go)
* [getbucketnotification.go](https://github.com/minio/minio-go/blob/master/examples/s3/getbucketnotification.go)
* [removeallbucketnotification.go](https://github.com/minio/minio-go/blob/master/examples/s3/removeallbucketnotification.go)
Update vendored dependencies
2019-11-22 13:57:56 +00:00
* [listenbucketnotification.go](https://github.com/minio/minio-go/blob/master/examples/minio/listenbucketnotification.go) (MinIO Extension)
Vendor dependencies with dep
2017-07-23 12:24:45 +00:00
Update dependencies
2017-09-13 12:09:48 +00:00
### Full Examples : File Object Operations
Vendor dependencies with dep
2017-07-23 12:24:45 +00:00
* [fputobject.go](https://github.com/minio/minio-go/blob/master/examples/s3/fputobject.go)
* [fgetobject.go](https://github.com/minio/minio-go/blob/master/examples/s3/fgetobject.go)
Update minio-go
2017-12-08 19:45:59 +00:00
* [fputobject-context.go](https://github.com/minio/minio-go/blob/master/examples/s3/fputobject-context.go)
* [fgetobject-context.go](https://github.com/minio/minio-go/blob/master/examples/s3/fgetobject-context.go)
Vendor dependencies with dep
2017-07-23 12:24:45 +00:00
Update dependencies
2017-09-13 12:09:48 +00:00
### Full Examples : Object Operations
Vendor dependencies with dep
2017-07-23 12:24:45 +00:00
* [putobject.go](https://github.com/minio/minio-go/blob/master/examples/s3/putobject.go)
* [getobject.go](https://github.com/minio/minio-go/blob/master/examples/s3/getobject.go)
Update minio-go
2017-12-08 19:45:59 +00:00
* [putobject-context.go](https://github.com/minio/minio-go/blob/master/examples/s3/putobject-context.go)
* [getobject-context.go](https://github.com/minio/minio-go/blob/master/examples/s3/getobject-context.go)
Vendor dependencies with dep
2017-07-23 12:24:45 +00:00
* [statobject.go](https://github.com/minio/minio-go/blob/master/examples/s3/statobject.go)
* [copyobject.go](https://github.com/minio/minio-go/blob/master/examples/s3/copyobject.go)
* [removeobject.go](https://github.com/minio/minio-go/blob/master/examples/s3/removeobject.go)
* [removeincompleteupload.go](https://github.com/minio/minio-go/blob/master/examples/s3/removeincompleteupload.go)
* [removeobjects.go](https://github.com/minio/minio-go/blob/master/examples/s3/removeobjects.go)
Update dependencies
2017-09-13 12:09:48 +00:00
### Full Examples : Encrypted Object Operations
Vendor dependencies with dep
2017-07-23 12:24:45 +00:00
* [put-encrypted-object.go](https://github.com/minio/minio-go/blob/master/examples/s3/put-encrypted-object.go)
* [get-encrypted-object.go](https://github.com/minio/minio-go/blob/master/examples/s3/get-encrypted-object.go)
Update minio-go
2017-12-08 19:45:59 +00:00
* [fput-encrypted-object.go](https://github.com/minio/minio-go/blob/master/examples/s3/fputencrypted-object.go)
Vendor dependencies with dep
2017-07-23 12:24:45 +00:00
Update dependencies
2017-09-13 12:09:48 +00:00
### Full Examples : Presigned Operations
Vendor dependencies with dep
2017-07-23 12:24:45 +00:00
* [presignedgetobject.go](https://github.com/minio/minio-go/blob/master/examples/s3/presignedgetobject.go)
* [presignedputobject.go](https://github.com/minio/minio-go/blob/master/examples/s3/presignedputobject.go)
Update dependencies
2017-09-13 12:09:48 +00:00
* [presignedheadobject.go](https://github.com/minio/minio-go/blob/master/examples/s3/presignedheadobject.go)
Vendor dependencies with dep
2017-07-23 12:24:45 +00:00
* [presignedpostpolicy.go](https://github.com/minio/minio-go/blob/master/examples/s3/presignedpostpolicy.go)
## Explore Further
Update vendored dependencies
2019-11-22 13:57:56 +00:00
* [Complete Documentation](https://docs.min.io)
* [MinIO Go Client SDK API Reference](https://docs.min.io/docs/golang-client-api-reference)
Vendor dependencies with dep
2017-07-23 12:24:45 +00:00
## Contribute
[Contributors Guide](https://github.com/minio/minio-go/blob/master/CONTRIBUTING.md)
[![Build Status](https://travis-ci.org/minio/minio-go.svg)](https://travis-ci.org/minio/minio-go)
[![Build status](https://ci.appveyor.com/api/projects/status/1d05e6nvxcelmrak?svg=true)](https://ci.appveyor.com/project/harshavardhana/minio-go)
Update minio-go
2017-12-08 19:45:59 +00:00
## License
This SDK is distributed under the [Apache License, Version 2.0](http://www.apache.org/licenses/LICENSE-2.0), see [LICENSE](./LICENSE) and [NOTICE](./NOTICE) for more information.
Copy permalink