AliyunGo: Go SDK for Aliyun Services

This is an unofficial Go SDK for Aliyun Services

Package Structure

ecs: Elastic Compute Service
oss: Open Storage Service
slb: Server Load Balancer
dns: DNS
common: Common libary of Aliyun Go SDK
util: Utility helpers

Quick Start

package main

import (
	"fmt"

	"github.com/denverdino/aliyungo/ecs"
)

const ACCESS_KEY_ID = "<YOUR_ID>"
const ACCESS_KEY_SECRET = "<****>"

func main() {
	client := ecs.NewClient(ACCESS_KEY_ID, ACCESS_KEY_SECRET)
	fmt.Print(client.DescribeRegions())
}

Documentation

Build and Install

go get:

go get github.com/denverdino/aliyungo

Test ECS

Modify "ecs/config_test.go"

	TestAccessKeyId     = "MY_ACCESS_KEY_ID"
	TestAccessKeySecret = "MY_ACCESS_KEY_ID"
	TestInstanceId      = "MY_INSTANCE_ID"
	TestIAmRich         = false

TestAccessKeyId: the Access Key Id
TestAccessKeySecret: the Access Key Secret.
TestInstanceId: the existing instance id for testing. It will be stopped and restarted during testing.
TestIAmRich(Optional): If it is set to true, it will perform tests to create virtual machines and disks under your account. And you will pay the bill. :-)

Under "ecs" and run

go test

Test OSS

Modify "oss/config_test.go"

	TestAccessKeyId     = "MY_ACCESS_KEY_ID"
	TestAccessKeySecret = "MY_ACCESS_KEY_ID"
	TestRegion          = oss.Beijing
	TestBucket          = "denverdino"

TestAccessKeyId: the Access Key Id
TestAccessKeySecret: the Access Key Secret.
TestRegion: the region of OSS for testing
TestBucket: the bucket name for testing

Under "oss" and run

go test

Contributors

Li Yi (denverdino@gmail.com)
tgic (farmer1992@gmail.com)
Yu Zhou (oscarrr110@gmail.com)
Yufei Zhang
linuxlikerqq

License

This project is licensed under the Apache License, Version 2.0. See LICENSE for the full license text.

Related projects

Aliyun ECS driver for Docker Machine: Pull request
Aliyun OSS driver for Docker Registry V2: Pull request

References

The GO API design of OSS refer the implementation from https://github.com/AdRoll/goamz

yangzx554/aliyungo