AWS SDK for Go
aws-sdk-go is the official AWS SDK for the Go programming language.
Caution
The SDK is currently in the process of being developed, and not everything
may be working fully yet. Please be patient and report any bugs or problems
you experience. The APIs may change radically without much warning, so please
vendor your dependencies with Godep or similar.
Please do not confuse this for a stable, feature-complete library.
Note that while most AWS protocols are currently supported, not all services
available in this package are implemented fully, as some require extra
customizations to work with the SDK. If you've encountered such a scenario,
please open a GitHub issue
so we can track work for the service.
Installing
Install your specific service package with the following go get
command.
For example, EC2 support might be installed with:
$ go get github.com/aws/aws-sdk-go/service/ec2
You can also install the entire SDK by installing the root package, including all of the SDK's dependancies:
$ go get -u github.com/aws/aws-sdk-go/...
Configuring Credentials
Before using the SDK, ensure that you've configured credentials. The best
way to configure credentials on a development machine is to use the
~/.aws/credentials
file, which might look like:
[default]
aws_access_key_id = AKID1234567890
aws_secret_access_key = MY-SECRET-KEY
You can learn more about the credentials file from this
blog post.
Alternatively, you can set the following environment variables:
AWS_ACCESS_KEY_ID=AKID1234567890
AWS_SECRET_ACCESS_KEY=MY-SECRET-KEY
Using
To use a service in the SDK, create a service variable by calling the New()
function. Once you have a service, you can call API operations which each
return response data and a possible error.
To list a set of instance IDs from EC2, you could run:
package main
import (
"fmt"
"github.com/aws/aws-sdk-go/aws"
"github.com/aws/aws-sdk-go/service/ec2"
)
func main() {
svc := ec2.New(&aws.Config{Region: "us-west-2"})
resp, err := svc.DescribeInstances(nil)
if err != nil {
panic(err)
}
fmt.Println("> Number of reservation sets: ", len(resp.Reservations))
for idx, res := range resp.Reservations {
fmt.Println(" > Number of instances: ", len(res.Instances))
for _, inst := range resp.Reservations[idx].Instances {
fmt.Println(" - Instance ID: ", *inst.InstanceID)
}
}
}
You can find more information and operations in our
API documentation.
License
This SDK is distributed under the
Apache License, Version 2.0,
see LICENSE.txt and NOTICE.txt for more information.