distribution/vendor/github.com/denverdino/aliyungo/README.md

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