b22c6b7a4e
Adds READMEs and enforces vendor is done at repository root Signed-off-by: Derek McGowan <derek@mcgstyle.net>
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