History

Derek McGowan b22c6b7a4e Update vendor directory to match expectation of vndr tool Adds READMEs and enforces vendor is done at repository root Signed-off-by: Derek McGowan <derek@mcgstyle.net>		2017-04-10 12:07:32 -07:00
..
common	oss data copy optimize after upload finished	2016-10-26 09:37:58 +08:00
oss	oss native large file copy consume too much time which will eventually lead to client timeout because of no data transmit throughout native copy. change maxCopySize to 128MB, ensure only sm all medium size file use oss native copy to avoid connection reset by peer. And fix Move function with CopyLargeFileInParallel to optimize oss upload copy	2016-11-08 12:14:13 +08:00
util	oss data copy optimize after upload finished	2016-10-26 09:37:58 +08:00
LICENSE.txt	Update vendor directory to match expectation of vndr tool	2017-04-10 12:07:32 -07:00
README.md	Update vendor directory to match expectation of vndr tool	2017-04-10 12:07:32 -07:00

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

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.

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