denverdino / aliyungo Goto Github PK

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.

License: Apache License 2.0

Go 100.00%

alibaba aliyun dns ecs go oss rds sdk slb

aliyungo's Introduction

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

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 ([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 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

aliyungo's People

Contributors

Stargazers

Watchers

Forkers

oscarrr110 yufeizyf chinanjjohn2012 masiqi ericzzy avldya leekay0032 yangzx554 chuchengcao lzbgt zeus911 fernando1987 ulricqin kingpro gonuuts jimmycmh hmgle firelyu haiyang1987 pkf aiden0z amzfans object8421 bswang guijun zhangrandl pksurecom keontang bping carryon shmilyday hdksky toolchainx zerolugithub chainone agelin herryliq forestkeeper duanqi go-fish softlns johnzeng liubin aoxn cuka hekexue xiaoheihero jackjet870 wangyuelucky yarous224 xiaozhu36 edenxia ledzep2 zhuzhih2017 zachcr caojianx demonwy shuwei-yin yhtsnda flzzyxymll41 sugeladi romesh-mccullough u900 mofelee bapleliu hb-chen lubaoyilang yinshengkui karfield anchnet chliang2030598 boy12371 snailwalker porson zhaojie-xu guoxu3 nuaays nashtsai tedyli phenixsh itsky365 eastmacro pragkent liu-junyong cnjp yu-fish yiwang2015 zhenfdfs yyzi khanchan jeff885 crazykev naokij yl10 zhunzhun1988 lujinda duguying pangdahua jiudaoyun lwk123

aliyungo's Issues

Can't kill & rm machine when create fail usingi aliyunecs driver

I'm trying to use docker-machine(0.5.0rc4) with aliyunecs driver and there are some issues.
First, I started to create swarm-ecs-master but there's TLS handshake timeout error:

$ docker-machine create --driver aliyunecs --swarm --swarm-master --swarm-discovery token://42391e615c9ee3ea568c92dddf9ee7a5 --engine-insecure-registry registry.mirrors.aliyuncs.com swarm-ecs-master 
Creating CA: /Users/jie/.docker/machine/certs/ca.pem
Creating client certificate: /Users/jie/.docker/machine/certs/cert.pem
Running pre-create checks...
Creating machine...
Error creating machine: Error in driver during machine creation: Aliyun Error: Status Code -1: Code AliyunGoClientFailure: Message Get https://ecs.aliyuncs.com?xxxxxxxx(Some security info has been removed): net/http: TLS handshake timeout

Recreate is not allowed:

$ docker-machine create --driver aliyunecs --swarm --swarm-master --swarm-discovery token://42391e615c9ee3ea568c92dddf9ee7a5 --engine-insecure-registry registry.mirrors.aliyuncs.com swarm-ecs-master 
Host already exists: "swarm-ecs-master"

Then, I tried to kill it but it still got error like below:

$ docker-machine kill swarm-ecs-master
swarm-ecs-master | Unable to kill instance : Aliyun Error: Status Code 400: Code MissingParameter: Message The input parameter "InstanceId" that is mandatory for processing this request is not supplied.

Run docker-machine ls just like this:

$ docker-machine ls
error getting URL for host swarm-ecs-master: Aliyun Error: Status Code 400: Code MissingParameter: Message The input parameter "InstanceId" that is mandatory for processing this request is not supplied.
error getting state for host swarm-ecs-master: Aliyun Error: Status Code 400: Code MissingParameter: Message The input parameter "InstanceId" that is mandatory for processing this request is not supplied.
NAME               ACTIVE   DRIVER      STATE   URL   SWARM
swarm-ecs-master   -        aliyunecs   Error         swarm-ecs-master (master)

AliyunSLB DeleteSLB ERROR:
Aliyun API Error: RequestId: XXXXXXXX Status Code: 400 Code:
MissingParameter Message: The input parameter "StickySession" that is mandatory for processing this request is not supplied.

Will Ali provide K8S plugin for OSS & SLB

When I set the endpoint as 'bucket.oss-cn-hangzhou-internal.aliyuncs.com', the docker registry fail to start.

I use the OSS as the docker registry backend. The registry container run on the ECS, I want to connect to OSS with internal endpoint. I get the internal endpoint url from ali guide.

storage:
    oss:
        accesskeyid: xxxxxxx
        accesskeysecret: yyyyyyyy
        region: oss-cn-hangzhou
        endpoint: bucket1.oss-cn-hangzhou-internal.aliyuncs.com
        internal: true
        bucket: bucket1

When I start the registry, it error out.

2016/01/23 06:42:41 GET https://bucket1.oss-cn-hangzhou-internal.aliyuncs.com/?delimiter=&marker=&max-keys=1&prefix=test ...
panic: Get https://bucket1.oss-cn-hangzhou-internal.aliyuncs.com/?delimiter=&marker=&max-keys=1&prefix=test: x509: certificate is valid for *.oss-internal.aliyuncs.com, not registry1.oss-cn-hangzhou-internal.aliyuncs.com

不适用于2017年6月22日以后的短信接口

调用错误：
Aliyun API Error: RequestId: 5D792366-E7EA-4615-A9F7-85E0FC148EE5 Status Code: 404 Code: InvalidDayuStatus.Malformed Message: The specified dayu status is wrongly formed.
希望大神能尽快补丁

Could endpoint be passed by an argument?

// NewClient creates a new instance of ECS client
func NewClient(accessKeyId, accessKeySecret string) *Client {
	endpoint := os.Getenv("ECS_ENDPOINT")
	if endpoint == "" {
		endpoint = ECSDefaultEndpoint
	}
	return NewClientWithEndpoint(endpoint, accessKeyId, accessKeySecret)
}

Although we can set endpoint by an Environment variable, It is not convenient.

How about Variadic Functions for NewClient？

func NewClient(accessKeyId, accessKeySecret, args ...string) *Client {
	endpoint := ""
	if len(args) > 0 {
		endpoint = args[0]
	} else {
		endpoint = os.Getenv("ECS_ENDPOINT")
		if endpoint == "" {
			endpoint = ECSDefaultEndpoint
		}
	}
	return NewClientWithEndpoint(endpoint, accessKeyId, accessKeySecret)
}

link of ECS Driver for Mac OSX is 404 not found

https://drone.io/github.com/denverdino/machine/files/driver/docker-machine-driver-aliyunecs_darwin-amd64.tgz

slb的HTTPListenerType缺少VServerGroup属性

根据 https://help.aliyun.com/document_detail/27602.html?spm=5176.doc27606.6.666.hIo2xa 的文档，为Listener配置默认的VServerGroup，除了需要VServerGroupId以外，还需要一个 VServerGroup 的参数，其类型为 slb.FlagType。
目前的API事实上无法为Listener配置VserverGroup。添加VServerGroup后，工作才正常。

ecs.LockReason unmarshal error

can not unmarshal LockReason result to ecs.LockReason struct (type string).

example response:

OperationLocks":{"LockReason":[{"LockReason":"financial"}]}

code and test cases should support go 1.2 1.3 and 1.4

$ go test
2015/06/06 22:58:33 StructArray.1. : {a 1}
2015/06/06 22:58:33 StructArray.2. : {x 2}
--- FAIL: TestISO8601Time (0.00 seconds)
    iso6801_test.go:29: Time 2015-06-06T14:58:33Z does not equal expected 2015-06-06T14:58:33Z
FAIL
exit status 1

$ go version
go version go1.3.3 linux/amd64

Some changes of API according to the latest doc.

According to this https://help.aliyun.com/document_detail/25687.html, instance status has some changes. Creating has become Pending and there is also a new one called Deleted.

Also, according to this https://help.aliyun.com/document_detail/25503.html, there is an added field UserData in ModifyInstanceAttributeArg.

请问是否有阿里云智能语音交互(asr tts)的sdk

Two questions

Does this SDK support "append" object?

I see PutReader has parameter type "io.Reader", instead of "io.ReaderSeeker". Does it mean this method can upload data as a stream (no need wait for EOF of the data)?

RDS support

硅谷节点支持么？

如果支持的话，MACHINE_DOCKER_INSTALL_URL 和 ecs_region 怎么写？

Better documentation and more samples

ECS driver of Docker Machine: Support PayByTraffic

So far, only PayByBandwidth is supported

ECS API: More user friendly API design

Current API design is just mapping of the REST API. It will be better to provide the resource based API. E.g. instance resource, disk resource we can associate the disk resource to instance
The WaitForXXX method can be simplified.
E.g.
func (client *Client) WaitForInstance(instanceId string, status InstanceStatus, timeout int) error
Should be changed to something like
func (client *Client) WaitForInstance(instanceId string, timeout int) (status InstanceStatus, err error)

The status will be the stable status E.g. Running, Stopped, etc. We need the enumeration of them.

Thanks

Provide tests that don't need network and ACCESS_KEY_ID

I intend to package this in Debian[1]. But I can't run this package's tests since the build env can't access network and we don't have aliyun's ACCESS_KEY_ID.

For now, I just disabled tests during packaging. But it's not good for package's quality. Please consider provide tests that don't need network and ACCESS_KEY_ID.

[1] https://bugs.debian.org/869819

type RecordType 中 TTL 类型错误

源码中，代码：
type RecordType struct {
DomainName string
RecordId string
RR string
Type string
Value string
TTL int32
Priority int32
Line string
Status string
Locked bool
}

实际返回结果中，TTL为string类型，实际请求结果如下：
"DomainRecords": {
"Record": [
{
"RR": "test",
"Status": "ENABLE",
"Value": "1.1.1.1",
"RecordId": "342037109689856011",
"Type": "A",
"DomainName": "example.com",
"Locked": false,
"Line": "default",
"TTL": "600"
}
]
}

请问消息队列是否会提供tcp版本的sdk?

mp出现Unknown Error

请问我用mq包，会我出现Unknown Error呢？

Add support for new regions; Japan, Germany, Dubai & Australia

HI,
Aliyun just released support for new regions: Japan, Germany, Dubai & Australia. Can these be added to the library.

On a side note, I tried to find the region ids for Aliyun. I could not find it from there api docs. Do you mind showing how to figure this out?

Thanks.

Aliyun registry version out of date

It prompted the below message after running 'docker pull mysql' successfully. In fact it behaves the same whatever I am pulling.

"docker.io/library/mysql: this image was pulled from a legacy registry. Important: This registry version will not be supported in future versions of docker."

I checked the configuration and found docker daemon is using registry.mirrors.aliyuncs.com as default registry. Is this registry maintained officially by Aliyun?

关于MNS

目前我需要用到MNS服务可否有提供MNS相关的demo

Remove associated route entry before instance deletion

Error removing machine test2: unable to terminate instance: ECS Error: Status Code 400: Code DependencyViolation.RouteEntry: Message Specified instance is used by route entry.

OSS driver for Docker Registry: Verify the ECS deployment

ECS -> OSS: internal traffic
Client -> ECS, and OSS: both internal/external traffic

SLB: can NOT get RuleId when DescribeRules

@denverdino

根据文档：https://help.aliyun.com/document_detail/35230.html?spm=5176.doc35226.6.676.mCU5KZ，当调用DescribeRules接口时，可以拿到所有的规则列表，但是返回的列表里只有RuleName，没有RuleId

使用场景：比如我想删除某个loadbalancer配置的所有Rules：

先调用DescribeRules接口拿到规则列表
然后调用DeleteRules接口删除规则。

问题是DescribeRules没有返回RuleId，而DeleteRules接口又需要RuleId作参数。
cc @superxi @ddysher

opensearch什么时候能提供v3版本的接口不

现在v2版本的接口，只能使用主账号的key,子账号的不能用。能提供一下v3版本的就好了。

SLB: No L7 loadbalancer Rules related API provided?

@denverdino
Seems this SDK does not provide SLB L7 loadbalancing rules related API, see: https://help.aliyun.com/document_detail/35226.html?spm=5176.doc35226.3.3.Grvi97

cc @superxi @ddysher

common.InternetChargeType must be lowercase

CreateLoadBalancerArgs InternetChargeType
InternetChargeType value is one of paybybandwidth and paybytraffic
https://help.aliyun.com/document_detail/27577.html?spm=5176.doc27592.6.617.am98PA

aliyun opensearch 包不能用。

Default value or zero value?

type ModifyScalingGroupArgs struct {
	ScalingGroupId               string
	ScalingGroupName             string
	ActiveScalingConfigurationId string
	MinSize                      int
	MaxSize                      int
	DefaultCooldown              int
	RemovalPolicy                common.FlattenArray
}

MinSize and MaxSize is allowed to set to 0, but the default value is also 0.
When set query value, aliyungo treat 0 as not set, this is not true sometimes.

case reflect.Uint, reflect.Uint8, reflect.Uint16, reflect.Uint32, reflect.Uint64:
			i := field.Uint()
			if i != 0 {
				value = strconv.FormatUint(i, 10)
			}

We better use a int pointer to indicate whether is zero value or value not set

slb could not use common.PayByBandwidth

ecs use PayByBandwidth:
https://help.aliyun.com/document_detail/25499.html?spm=5176.product25365.6.235.VIlqu1

but slb use paybytraffic:
https://help.aliyun.com/document_detail/27577.html?spm=5176.product27537.6.118.R6Bqe6

So, slb could not use common.PayByBandwidth in CreateLoadBalancerArgs struct:

type CreateLoadBalancerArgs struct {
    RegionId           common.Region
    LoadBalancerName   string
    AddressType        AddressType
    VSwitchId          string
    InternetChargeType common.InternetChargeType
    Bandwidth          int
    ClientToken        string
}

TODO: Add the .drone.yml

Currently, the build project is in https://drone.io/github.com/denverdino/aliyungo

No DomainGroup related API provided

@denverdino

DomainGroup related document is at https://help.aliyun.com/document_detail/29762.html?spm=5176.doc29762.3.3.blxLT1

BTW, aliyun dose not support DescribeDoaminGroup ? I want to list all domain in a group.

add the interface of getting zone-id from metadata

I have used your repo to get information of metadata, but i can't find the interface of getting zone-id. So i add it.

I found DescribeInstances support fuzzy query, but it lacks some documents

For example, it supports this fuzzy query kube-*:

args1 := ecs.DescribeInstancesArgs{
        RegionId:     "cn-beijing",
        InstanceName: "kube-*",
        Status:       ecs.Running,
    }
    instance, _, err := client.DescribeInstances(&args1)

I got the result:

[]ecs.InstanceAttributesType{ecs.InstanceAttributesType{InstanceId:"i-25ruedcj2", InstanceName:"kube-master", ...},
ecs.InstanceAttributesType{InstanceId:"i-25zf0s2mo", InstanceName:"kube-node1",  ...},
ecs.InstanceAttributesType{InstanceId:"i-25lx43e3z", InstanceName:"kube-node2", ...},
ecs.InstanceAttributesType{InstanceId:"i-25mo0ad2d", InstanceName:"kube-node3", ...}

ECS driver of Docker Machine: Support additional disks

Is ecs default Enpoint is correct?

I saw document (https://help.aliyun.com/document_detail/25489.html?spm=5176.doc25492.6.686.RpFcit) and it said that entry point is <ecs.aliyuncs.com>.

But i see https://github.com/denverdino/aliyungo/blob/master/ecs/client.go#L20 and it is "https://ecs-cn-hangzhou.aliyuncs.com" by default.

It will lead to "Error creating machine: Error in driver during machine creation: Aliyun API Error: ... dial tcp 140.205.155.65:443: i/o timeout" when i create ecs instance.

局域网访问

请问如何在阿里云内ECS里使用OSS内网推送？

Status Code: 403: OperationDenied Message

我在调试 API 时遇到：

* aliyun_ecs_instance.test01: Failed to create instance from Image ubuntu1404_64_40G_aliaegis_20160222.vhd: Aliyun API Error: RequestId: D0CC639E-180D-4827-97CB-FC609F6C95CD Status Code: 403 Code: OperationDenied Message: The resource is out of usage.

请问该如何解决？

Let me know if you have any comments, thanks.

SLB CreateRule接口返回500错误

请求json：

[{"RuleId":"","RuleName":"32507","Domain":"caicloud.io","Url":"","VServerGroupId":"rsp-wz9ulsi3q77ec"}]

报错:

Aliyun API Error: RequestId: 96AC3877-44F5-46C5-B6F6-D9E57CB9AAAD Status Code: 500 Code: InternalError Message: The request processing has failed due to some unknown error, exception or failure.

denverdino / aliyungo Goto Github PK

aliyungo's Introduction

AliyunGo: Go SDK for Aliyun Services

Package Structure

Quick Start

Documentation

Build and Install

Test ECS

Test OSS

Contributors

License

Related projects

References

aliyungo's People

Contributors

Stargazers

Watchers

Forkers

aliyungo's Issues

Recommend Projects

Recommend Topics

Recommend Org