yu-fish / aliyungo

Go SDK for Aliyun (Alibaba Cloud) - Golang API for ECS, OSS, DNS, SLB, RDS, RAM, MNS, STS, SLS, MQ, Push, OpenSearch, DM, Container Service etc.

AliyunGo: Go SDK for Aliyun Services

This is an unofficial Go SDK for Aliyun Services. You are welcome for contribution.

Package Structure

• ecs: Elastic Compute Service
• oss: Open Storage Service
• slb: Server Load Balancer
• dns: DNS
• sls: Logging Service
• ram: Resource Access Management
• rds: Relational Database Service
• cms: Cloud Monitor Service
• cs: Container Service
• sts: Security Token Service
• dm: Direct Mail
• sms: Short Message Service
• push: Cloud Mobile Push
• opensearch: OpenSearch
• mq: Message Queue
• nas: Network Attached Storage
• 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

• ECS: https://godoc.org/github.com/denverdino/aliyungo/ecs
• OSS: https://godoc.org/github.com/denverdino/aliyungo/oss
• SLB: https://godoc.org/github.com/denverdino/aliyungo/slb
• DNS: https://godoc.org/github.com/denverdino/aliyungo/dns
• SLS: https://godoc.org/github.com/denverdino/aliyungo/sls
• RAM: https://godoc.org/github.com/denverdino/aliyungo/ram
• RDS: https://godoc.org/github.com/denverdino/aliyungo/rds
• CMS: https://godoc.org/github.com/denverdino/aliyungo/cms
• CS: https://godoc.org/github.com/denverdino/aliyungo/cs
• STS: https://godoc.org/github.com/denverdino/aliyungo/sts
• DM: https://godoc.org/github.com/denverdino/aliyungo/dm
• SMS: https://godoc.org/github.com/denverdino/aliyungo/sms
• MQ: https://godoc.org/github.com/denverdino/aliyungo/mq
• NAS: https://godoc.org/github.com/denverdino/aliyungo/nas
• OPENSEARCH: https://godoc.org/github.com/denverdino/aliyungo/opensearch
• PUSH: https://godoc.org/github.com/denverdino/aliyungo/push

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 ([email protected])
• Boshi Lian ([email protected])
• Yu Zhou ([email protected])
• Yufei Zhang
• linuxlikerqq
• Changhai Yan
• Jizhong Jiang ([email protected])
• Kent Wang ([email protected])
• ringtail
• aiden0z ([email protected])
• jimmycmh
• menglingwei
• mingang.he ([email protected])
• Young Chen ([email protected])
• johnzeng
• spacexnice ([email protected])
• xiaoheihero
• hmgle ([email protected])
• jzwlqx ([email protected])
• Linhua Tan ([email protected])
• Plutonist ([email protected])
• Bin Liu
• wangyue
• demonwy
• yarous224
• yufeizyf ([email protected])
• keontang ([email protected])
• Cholerae Hu ([email protected])
• Zach Bergh ([email protected])
• Bingshen Wang
• xiaozhu36
• Russell ([email protected])
• zhuzhih2017
• cheyang
• Hobo Chen
• Shuwei Yin

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