/aws-sdk-go

An incredibly experimental, automatically generated set of AWS clients in Go.

Primary LanguageGoApache License 2.0Apache-2.0

AWS SDK for Go

GoDoc Build Status Apache V2 License

The AWS SDK for Go is a set of clients for all Amazon Web Services APIs that initially started as Stripe's aws-go library, and is currently under development to implement full service coverage and other standard AWS SDK features.

Note: Active development is currently happening in the develop branch. See this branch to follow along with API changes and ongoing refactors. The master branch will continue to maintain the current API of Stripe's aws-go library until the develop branch is more stable.

Caution

It is currently highly untested, so please be patient and report any bugs or problems you experience. The APIs may change radically without much warning, so please vendor your dependencies w/ Godep or similar.

Please do not confuse this for a stable, feature-complete library.

Note that many services are currently not fully implemented. Some operations might work, but not all, especially for XML-based services. We are currently working to build out better service support, please bear with us!

Installing

Let's say you want to use EC2:

$ go get github.com/awslabs/aws-sdk-go/gen/ec2

Using

import "github.com/awslabs/aws-sdk-go/aws"
import "github.com/awslabs/aws-sdk-go/gen/ec2"

creds := aws.Creds(accessKey, secretKey, "")
cli := ec2.New(creds, "us-west-2", nil)
resp, err := cli.DescribeInstances(nil)
if err != nil {
    panic(err)
}
fmt.Println(resp.Reservations)