Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/denverdino/aliyungo

Go SDK for Aliyun (Alibaba Cloud) - Golang API for ECS, OSS, DNS, SLB, RDS, RAM, MNS, STS, SLS, MQ, Push, OpenSearch, DM, Container Service etc.
https://github.com/denverdino/aliyungo

alibaba aliyun dns ecs go oss rds sdk slb

Last synced: 10 days ago
JSON representation

Go SDK for Aliyun (Alibaba Cloud) - Golang API for ECS, OSS, DNS, SLB, RDS, RAM, MNS, STS, SLS, MQ, Push, OpenSearch, DM, Container Service etc.

Host: GitHub
URL: https://github.com/denverdino/aliyungo
Owner: denverdino
License: apache-2.0
Created: 2015-04-26T23:42:22.000Z (about 9 years ago)
Default Branch: master
Last Pushed: 2024-01-02T01:29:14.000Z (6 months ago)
Last Synced: 2024-06-19T11:07:13.751Z (17 days ago)
Topics: alibaba, aliyun, dns, ecs, go, oss, rds, sdk, slb
Language: Go
Homepage:
Size: 5.9 MB
Stars: 842
Watchers: 56
Forks: 247
Open Issues: 31
Metadata Files:
- Readme: README.md
- License: LICENSE.txt

Lists

awesome-golang-repositories - aliyungo - Golang API for ECS, OSS, DNS, SLB, RDS, RAM, MNS, STS, SLS, MQ, Push, OpenSearch, DM, Container Service etc. (Repositories)
awesome-stars - aliyungo - Go SDK for Aliyun Services (ECS, OSS, DNS, SLB, RAM and SLS) (Go)
awesome-stars - denverdino/aliyungo - `★843` Go SDK for Aliyun (Alibaba Cloud) - Golang API for ECS, OSS, DNS, SLB, RDS, RAM, MNS, STS, SLS, MQ, Push, OpenSearch, DM, Container Service etc. (Go)

README

        # AliyunGo: Go SDK for Aliyun Services

[![Build Status](https://travis-ci.org/denverdino/aliyungo.svg?branch=master)](https://travis-ci.org/denverdino/aliyungo) [![CircleCI](https://circleci.com/gh/denverdino/aliyungo.svg?style=svg)](https://circleci.com/gh/denverdino/aliyungo) [![Go Report Card](https://goreportcard.com/badge/github.com/denverdino/aliyungo)](https://goreportcard.com/report/github.com/denverdino/aliyungo)

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](https://help.aliyun.com/document_detail/27101.html)

* cms: [Cloud Monitor Service](https://help.aliyun.com/document_detail/28615.html)

* cs: [Container Service](https://help.aliyun.com/product/25972.html)

* dm: [Direct Mail](https://help.aliyun.com/document_detail/29414.html)

* dns: [DNS](https://help.aliyun.com/document_detail/dns/api-reference/summary.html)

* ecs: [Elastic Compute Service](https://help.aliyun.com/document_detail/ecs/open-api/summary.html)

* ess: [Auto Scaling](https://help.aliyun.com/document_detail/25857.html)

* mns: [Message Service](https://help.aliyun.com/document_detail/27414.html)

* mq: [Message Queue](https://help.aliyun.com/document_detail/29532.html)

* nas: [Network Attached Storage](https://help.aliyun.com/document_detail/27518.html)

* opensearch: [OpenSearch](https://help.aliyun.com/document_detail/29118.html)

* oss: [Open Storage Service](https://help.aliyun.com/document_detail/oss/api-reference/abstract.html)

* push: [Cloud Mobile Push](https://help.aliyun.com/document_detail/30049.html)

* rds: [Relational Database Service](https://help.aliyun.com/document_detail/26226.html)

* ram: [Resource Access Management](https://help.aliyun.com/document_detail/ram/ram-api-reference/intro/intro.html)

* slb: [Server Load Balancer](https://help.aliyun.com/document_detail/slb/api-reference/brief-introduction.html)

* sls: [Logging Service](https://help.aliyun.com/document_detail/sls/api/overview.html)

* sms: [Short Message Service](https://help.aliyun.com/product/44282.html)

* sts: [Security Token Service](https://help.aliyun.com/document_detail/28756.html)

* common: Common libary of Aliyun Go SDK

* util: Utility helpers

## Quick Start

```go

package main

import (

  "fmt"

	"github.com/denverdino/aliyungo/ecs"

)

const ACCESS_KEY_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](https://godoc.org/github.com/denverdino/aliyungo/cdn)[![GoDoc](https://godoc.org/github.com/denverdino/aliyungo/cdn?status.svg)](https://godoc.org/github.com/denverdino/aliyungo/cdn)

  * CMS: [https://godoc.org/github.com/denverdino/aliyungo/cms](https://godoc.org/github.com/denverdino/aliyungo/cms) [![GoDoc](https://godoc.org/github.com/denverdino/aliyungo/cms?status.svg)](https://godoc.org/github.com/denverdino/aliyungo/cms)

  * CS: [https://godoc.org/github.com/denverdino/aliyungo/cs](https://godoc.org/github.com/denverdino/aliyungo/cs) [![GoDoc](https://godoc.org/github.com/denverdino/aliyungo/cs?status.svg)](https://godoc.org/github.com/denverdino/aliyungo/cs)

  * DM: [https://godoc.org/github.com/denverdino/aliyungo/dm](https://godoc.org/github.com/denverdino/aliyungo/dm) [![GoDoc](https://godoc.org/github.com/denverdino/aliyungo/dm?status.svg)](https://godoc.org/github.com/denverdino/aliyungo/dm)

  * DNS: [https://godoc.org/github.com/denverdino/aliyungo/dns](https://godoc.org/github.com/denverdino/aliyungo/dns) [![GoDoc](https://godoc.org/github.com/denverdino/aliyungo/dns?status.svg)](https://godoc.org/github.com/denverdino/aliyungo/dns)

  * ECS: [https://godoc.org/github.com/denverdino/aliyungo/ecs](https://godoc.org/github.com/denverdino/aliyungo/ecs) [![GoDoc](https://godoc.org/github.com/denverdino/aliyungo/ecs?status.svg)](https://godoc.org/github.com/denverdino/aliyungo/ecs)

  * ESS: [https://godoc.org/github.com/denverdino/aliyungo/ess](https://godoc.org/github.com/denverdino/aliyungo/ess)[![GoDoc](https://godoc.org/github.com/denverdino/aliyungo/ess?status.svg)](https://godoc.org/github.com/denverdino/aliyungo/ess)

  * MNS: [https://godoc.org/github.com/denverdino/aliyungo/mns](https://godoc.org/github.com/denverdino/aliyungo/mns)[![GoDoc](https://godoc.org/github.com/denverdino/aliyungo/mns?status.svg)](https://godoc.org/github.com/denverdino/aliyungo/mns)

  * MQ: [https://godoc.org/github.com/denverdino/aliyungo/mq](https://godoc.org/github.com/denverdino/aliyungo/mq) [![GoDoc](https://godoc.org/github.com/denverdino/aliyungo/mq?status.svg)](https://godoc.org/github.com/denverdino/aliyungo/mq)

  * NAS: [https://godoc.org/github.com/denverdino/aliyungo/nas](https://godoc.org/github.com/denverdino/aliyungo/nas) [![GoDoc](https://godoc.org/github.com/denverdino/aliyungo/nas?status.svg)](https://godoc.org/github.com/denverdino/aliyungo/nas)

  * OPENSEARCH: [https://godoc.org/github.com/denverdino/aliyungo/opensearch](https://godoc.org/github.com/denverdino/aliyungo/opensearch) [![GoDoc](https://godoc.org/github.com/denverdino/aliyungo/opensearch?status.svg)](https://godoc.org/github.com/denverdino/aliyungo/opensearch)

  * OSS: [https://godoc.org/github.com/denverdino/aliyungo/oss](https://godoc.org/github.com/denverdino/aliyungo/oss) [![GoDoc](https://godoc.org/github.com/denverdino/aliyungo/oss?status.svg)](https://godoc.org/github.com/denverdino/aliyungo/oss)

  * PUSH: [https://godoc.org/github.com/denverdino/aliyungo/push](https://godoc.org/github.com/denverdino/aliyungo/push) [![GoDoc](https://godoc.org/github.com/denverdino/aliyungo/push?status.svg)](https://godoc.org/github.com/denverdino/aliyungo/push)

  * RAM: [https://godoc.org/github.com/denverdino/aliyungo/ram](https://godoc.org/github.com/denverdino/aliyungo/ram) [![GoDoc](https://godoc.org/github.com/denverdino/aliyungo/ram?status.svg)](https://godoc.org/github.com/denverdino/aliyungo/ram)

  * RDS: [https://godoc.org/github.com/denverdino/aliyungo/rds](https://godoc.org/github.com/denverdino/aliyungo/rds) [![GoDoc](https://godoc.org/github.com/denverdino/aliyungo/rds?status.svg)](https://godoc.org/github.com/denverdino/aliyungo/rds)

  * SLB: [https://godoc.org/github.com/denverdino/aliyungo/slb](https://godoc.org/github.com/denverdino/aliyungo/slb) [![GoDoc](https://godoc.org/github.com/denverdino/aliyungo/slb?status.svg)](https://godoc.org/github.com/denverdino/aliyungo/slb)

  * SLS: [https://godoc.org/github.com/denverdino/aliyungo/sls](https://godoc.org/github.com/denverdino/aliyungo/sls) [![GoDoc](https://godoc.org/github.com/denverdino/aliyungo/sls?status.svg)](https://godoc.org/github.com/denverdino/aliyungo/sls)

  * SMS: [https://godoc.org/github.com/denverdino/aliyungo/sms](https://godoc.org/github.com/denverdino/aliyungo/sms) [![GoDoc](https://godoc.org/github.com/denverdino/aliyungo/sms?status.svg)](https://godoc.org/github.com/denverdino/aliyungo/sms)

  * STS: [https://godoc.org/github.com/denverdino/aliyungo/sts](https://godoc.org/github.com/denverdino/aliyungo/sts) [![GoDoc](https://godoc.org/github.com/denverdino/aliyungo/sts?status.svg)](https://godoc.org/github.com/denverdino/aliyungo/sts)

## Build and Install

go get:

```sh

go get github.com/denverdino/aliyungo

```

## Test ECS

Modify "ecs/config_test.go"

```sh

	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

```sh

go test

```

## Test OSS

Modify "oss/config_test.go"

```sh

	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

```sh

go test

```

## Contributors

  * Li Yi ([email protected])

  * Boshi Lian ([email protected])

  * Yu Zhou ([email protected])

  * Yufei Zhang

  * linuxlikerqq

  * Changhai Yan

  * Jizhong Jiang ([email protected])

  * Kent Wang ([email protected])

  * ringtail

  * aiden0z ([email protected])

  * jimmycmh

  * menglingwei

  * mingang.he ([email protected])

  * Young Chen ([email protected])

  * johnzeng

  * spacexnice ([email protected])

  * xiaoheihero

  * hmgle ([email protected])

  * jzwlqx ([email protected])

  * Linhua Tan ([email protected])

  * Plutonist ([email protected])

  * Bin Liu

  * wangyue

  * demonwy

  * yarous224

  * yufeizyf ([email protected])

  * keontang ([email protected])

  * Cholerae Hu ([email protected])

  * Zach Bergh ([email protected])

  * Bingshen Wang

  * xiaozhu36

  * Russell ([email protected])

  * zhuzhih2017

  * cheyang

  * Hobo Chen

  * Shuwei Yin

  * Xujin Zheng ([email protected])

  * Dino Lai ([email protected])

## License

This project is licensed under the Apache License, Version 2.0. See [LICENSE](https://github.com/denverdino/aliyungo/blob/master/LICENSE.txt) for the full license text.

## Related projects

  * Aliyun ECS driver for Docker Machine: [Pull request](https://github.com/docker/machine/pull/1182)

  * Aliyun OSS driver for Docker Registry V2: [Pull request](https://github.com/docker/distribution/pull/514)

## References

The GO API design of OSS refer the implementation from [https://github.com/AdRoll/goamz](https://github.com/AdRoll)