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 (denverdino@gmail.com)
- Boshi Lian (farmer1992@gmail.com)
- Yu Zhou (oscarrr110@gmail.com)
- Yufei Zhang
- linuxlikerqq
- Changhai Yan
- Jizhong Jiang (jiangjizhong@gmail.com)
- Kent Wang (pragkent@gmail.com)
- ringtail
- aiden0z (aiden0xz@gmail.com)
- jimmycmh
- menglingwei
- mingang.he (dustgle@gmail.com)
- Young Chen (chainone@gmail.com)
- johnzeng
- spacexnice (445436286@qq.com)
- xiaoheihero
- hmgle (dustgle@gmail.com)
- jzwlqx (jiangjizhong@gmail.com)
- Linhua Tan (toolchainX@gmail.com)
- Plutonist (p@vecsight.com)
- Bin Liu
- wangyue
- demonwy
- yarous224
- yufeizyf (xazyf9111@sina.cn)
- keontang (ikeontang@gmail.com)
- Cholerae Hu (me@cholerae.com)
- Zach Bergh (berghzach@gmail.com)
- Bingshen Wang
- xiaozhu36
- Russell (yufeiwu@gmail.com)
- zhuzhih2017
- cheyang
- Hobo Chen
- Shuwei Yin
- Xujin Zheng (xujinzheng@gmail.com)
- Dino Lai (dinos80152@gmail.com)
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