Tzyark / 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.

The official SDK for Aliyun services is published. Please visit https://github.com/aliyun/alibaba-cloud-sdk-go for details

Package Structure

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

• CDN: https://godoc.org/github.com/denverdino/aliyungo/cdn
• CMS: https://godoc.org/github.com/denverdino/aliyungo/cms
• CS: https://godoc.org/github.com/denverdino/aliyungo/cs
• DM: https://godoc.org/github.com/denverdino/aliyungo/dm
• DNS: https://godoc.org/github.com/denverdino/aliyungo/dns
• ECS: https://godoc.org/github.com/denverdino/aliyungo/ecs
• ESS: https://godoc.org/github.com/denverdino/aliyungo/ess
• MNS: https://godoc.org/github.com/denverdino/aliyungo/mns
• 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
• OSS: https://godoc.org/github.com/denverdino/aliyungo/oss
• PUSH: https://godoc.org/github.com/denverdino/aliyungo/push
• RAM: https://godoc.org/github.com/denverdino/aliyungo/ram
• RDS: https://godoc.org/github.com/denverdino/aliyungo/rds
• SLB: https://godoc.org/github.com/denverdino/aliyungo/slb
• SLS: https://godoc.org/github.com/denverdino/aliyungo/sls
• SMS: https://godoc.org/github.com/denverdino/aliyungo/sms
• STS: https://godoc.org/github.com/denverdino/aliyungo/sts

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

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