5.9 KiB
		
	
	
	
	
			
		
		
	
	
			5.9 KiB
		
	
	
	
	
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
 - sts: Security Token Service
 - dm: [Direct Mail] (https://help.aliyun.com/document_detail/29414.html)
 - 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 
 - STS: https://godoc.org/github.com/denverdino/aliyungo/sts 
 - DM: https://godoc.org/github.com/denverdino/aliyungo/dm 
 
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
 - Changhai Yan (changhai.ych@alibaba-inc.com)
 - Jizhong Jiang (jiangjizhong@gmail.com)
 - Kent Wang (pragkent@gmail.com)
 - ringtail (zhongwei.lzw@alibaba-inc.com)
 - aiden0z (aiden0xz@gmail.com)
 - jimmycmh
 - menglingwei
 - mingang.he (dustgle@gmail.com)
 - chainone (chainone@gmail.com)
 - johnzeng
 
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