aliyungo

README

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/51idc/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/51idc/aliyungo/ecs
• OSS: https://godoc.org/github.com/51idc/aliyungo/oss
• SLB: https://godoc.org/github.com/51idc/aliyungo/slb
• DNS: https://godoc.org/github.com/51idc/aliyungo/dns
• SLS: https://godoc.org/github.com/51idc/aliyungo/sls
• RAM: https://godoc.org/github.com/51idc/aliyungo/ram
• RDS: https://godoc.org/github.com/51idc/aliyungo/rds
• CMS: https://godoc.org/github.com/51idc/aliyungo/cms
• CS: https://godoc.org/github.com/51idc/aliyungo/cs
• STS: https://godoc.org/github.com/51idc/aliyungo/sts
• DM: https://godoc.org/github.com/51idc/aliyungo/dm
• SMS: https://godoc.org/github.com/51idc/aliyungo/sms
• MQ: https://godoc.org/github.com/51idc/aliyungo/mq
• NAS: https://godoc.org/github.com/51idc/aliyungo/nas
• OPENSEARCH: https://godoc.org/github.com/51idc/aliyungo/opensearch
• PUSH: https://godoc.org/github.com/51idc/aliyungo/push

Build and Install

go get:

go get github.com/51idc/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)
• Boshi Lian (farmer1992@gmail.com)
• Yu Zhou (oscarrr110@gmail.com)
• Yufei Zhang
• linuxlikerqq
• Changhai Yan
• Jizhong Jiang (jiangjizhong@gmail.com)
• Kent Wang (pragkent@gmail.com)
• ringtail
• aiden0z (aiden0xz@gmail.com)
• jimmycmh
• menglingwei
• mingang.he (dustgle@gmail.com)
• Young Chen (chainone@gmail.com)
• johnzeng
• spacexnice (445436286@qq.com)
• xiaoheihero
• hmgle (dustgle@gmail.com)
• jzwlqx (jiangjizhong@gmail.com)
• Linhua Tan (toolchainX@gmail.com)
• Plutonist (p@vecsight.com)
• Bin Liu
• wangyue
• demonwy
• yarous224
• yufeizyf (xazyf9111@sina.cn)
• keontang (ikeontang@gmail.com)
• Cholerae Hu (me@cholerae.com)
• Zach Bergh (berghzach@gmail.com)
• Bingshen Wang
• xiaozhu36
• Russell (yufeiwu@gmail.com)
• 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