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.

Github stars Tracking Chart

AliyunGo: Go SDK for Aliyun Services

Build Status CircleCI Go Report Card

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

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

License

This project is licensed under the Apache License, Version 2.0. See LICENSE for the full license text.

References

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

Main metrics

Overview
Name With Ownerdenverdino/aliyungo
Primary LanguageGo
Program languageGo (Language Count: 1)
Platform
License:Apache License 2.0
所有者活动
Created At2015-04-26 23:42:22
Pushed At2024-01-02 01:29:14
Last Commit At2023-04-11 20:48:12
Release Count0
用户参与
Stargazers Count839
Watchers Count56
Fork Count244
Commits Count1k
Has Issues Enabled
Issues Count86
Issue Open Count21
Pull Requests Count371
Pull Requests Open Count10
Pull Requests Close Count34
项目设置
Has Wiki Enabled
Is Archived
Is Fork
Is Locked
Is Mirror
Is Private