1[English](./README.md) | 简体中文 2 3<p align="center"> 4<a href=" https://www.alibabacloud.com"><img src="https://aliyunsdk-pages.alicdn.com/icons/Aliyun.svg"></a> 5</p> 6 7<h1 align="center">Alibaba Cloud SDK for Go</h1> 8 9<p align="center"> 10<a href="https://badge.fury.io/gh/aliyun%2Falibaba-cloud-sdk-go"><img src="https://badge.fury.io/gh/aliyun%2Falibaba-cloud-sdk-go.svg" alt="Latest Stable Version"></a> 11<a href="https://app.fossa.io/projects/git%2Bgithub.com%2Faliyun%2Falibaba-cloud-sdk-go?ref=badge_shield"><img src="https://app.fossa.io/api/projects/git%2Bgithub.com%2Faliyun%2Falibaba-cloud-sdk-go.svg?type=shield" alt="License"></a> 12<br/> 13<a href="https://codecov.io/gh/aliyun/alibaba-cloud-sdk-go"><img src="https://codecov.io/gh/aliyun/alibaba-cloud-sdk-go/branch/master/graph/badge.svg" alt="codecov"></a> 14<a href="https://travis-ci.org/aliyun/alibaba-cloud-sdk-go"><img src="https://travis-ci.org/aliyun/alibaba-cloud-sdk-go.svg?branch=master" alt="Travis Build Status"></a> 15<a href="https://ci.appveyor.com/project/aliyun/alibaba-cloud-sdk-go/branch/master"><img src="https://ci.appveyor.com/api/projects/status/1hiuo3ppx5j49psv/branch/master?svg=true" alt="Appveyor Build Status"></a> 16<a href="https://app.codacy.com/app/aliyun/alibaba-cloud-sdk-go?utm_source=github.com&utm_medium=referral&utm_content=aliyun/alibaba-cloud-sdk-go&utm_campaign=Badge_Grade_Dashboard"><img src="https://api.codacy.com/project/badge/Grade/291a39e242364b04ad442f0cce0e30d5" alt="Codacy Badge"></a> 17<a href="https://goreportcard.com/report/github.com/aliyun/alibaba-cloud-sdk-go"><img src="https://goreportcard.com/badge/github.com/aliyun/alibaba-cloud-sdk-go" alt="Go Report Card"></a> 18</p> 19 20欢迎使用 Alibaba Cloud SDK for Go。Alibaba Cloud SDK for Go 让您不用复杂编程即可访问云服务器、云监控等多个阿里云服务。 21这里向您介绍如何获取 [Alibaba Cloud SDK for Go][SDK] 并开始调用。 22 23## 在线示例 24[API Explorer][open-api] 提供在线调用阿里云产品,并动态生成 SDK 代码和快速检索接口等能力,能显著降低使用云 API 的难度。 25 26 27## 环境要求 28- 您的系统需要达到 [环境要求][Requirements], 例如,安装了不低于 1.10.x 版本的 Go 环境。 29 30## 安装 31使用 `go get` 下载安装 SDK 32 33```sh 34$ go get -u github.com/aliyun/alibaba-cloud-sdk-go/sdk 35``` 36 37如果您使用了 glide 管理依赖,您也可以使用 glide 来安装 Alibaba Cloud SDK for Go 38 39```sh 40$ glide get github.com/aliyun/alibaba-cloud-sdk-go 41``` 42 43另外,Alibaba Cloud SDK for Go 也会发布在 https://develop.aliyun.com/tools/sdk#/go 这个地址。 44 45## 快速使用 46在您开始之前,您需要注册阿里云帐户并获取您的[凭证](https://usercenter.console.aliyun.com/#/manage/ak)。 47 48### 创建客户端 49```go 50package main 51 52import "github.com/aliyun/alibaba-cloud-sdk-go/sdk" 53 54func main() { 55 56 client, err := sdk.NewClientWithAccessKey("REGION_ID", "ACCESS_KEY_ID", "ACCESS_KEY_SECRET") 57 if err != nil { 58 // Handle exceptions 59 panic(err) 60 } 61} 62``` 63 64### ROA 请求 65```go 66package main 67 68import "github.com/aliyun/alibaba-cloud-sdk-go/sdk/requests" 69 70func main() { 71 request := requests.NewCommonRequest() // 构造一个公共请求 72 request.Method = "GET" // 设置请求方式 73 request.Product = "CS" // 指定产品 74 request.Domain = "cs.aliyuncs.com" // 指定域名则不会寻址,如认证方式为 Bearer Token 的服务则需要指定 75 request.Version = "2015-12-15" // 指定产品版本 76 request.PathPattern = "/clusters/[ClusterId]" // 指定ROA风格路径规则 77 request.ApiName = "DescribeCluster" // 指定接口名 78 request.QueryParams["ClusterId"] = "123456" // 设置参数值 79 request.QueryParams["RegionId"] = "region_id" // 指定请求的区域,不指定则使用客户端区域、默认区域 80 request.TransToAcsRequest() // 把公共请求转化为acs请求 81} 82``` 83 84### RPC 请求 85```go 86package main 87 88import "github.com/aliyun/alibaba-cloud-sdk-go/sdk/requests" 89 90func main() { 91 request := requests.NewCommonRequest() // 构造一个公共请求 92 request.Method = "POST" // 设置请求方式 93 request.Product = "Ecs" // 指定产品 94 request.Domain = "ecs.aliyuncs.com" // 指定域名则不会寻址,如认证方式为 Bearer Token 的服务则需要指定 95 request.Version = "2014-05-26" // 指定产品版本 96 request.ApiName = "CreateInstance" // 指定接口名 97 request.QueryParams["InstanceType"] = "ecs.g5.large" // 设置参数值 98 request.QueryParams["RegionId"] = "region_id" // 指定请求的区域,不指定则使用客户端区域、默认区域 99 request.TransToAcsRequest() // 把公共请求转化为acs请求 100} 101``` 102 103 104## 文档 105* [Requirements](docs/0-Requirements-CN.md) 106* [Installation](docs/1-Installation-CN.md) 107* [Client](docs/2-Client-CN.md) 108* [SSL Verify](docs/3-Verify-CN.md) 109* [Proxy](docs/4-Proxy-CN.md) 110* [Timeout](docs/5-Timeout-CN.md) 111* [Debug](docs/6-Debug-CN.md) 112* [Logger](docs/7-Logger-CN.md) 113* [Concurrent](docs/8-Concurrent-CN.md) 114* [Asynchronous Call](docs/9-Asynchronous-CN.md) 115* [Package Management](docs/10-Package-Management-CN.md) 116 117 118## 问题 119[提交 Issue][issue] 不符合指南的问题可能会立即关闭。 120 121 122## 贡献 123提交 Pull Request 之前请阅读[贡献指南](CONTRIBUTING.md)。 124 125## 相关 126* [阿里云服务 Regions & Endpoints][endpoints] 127* [OpenAPI Explorer][open-api] 128* [Go][go] 129* [最新发行版本][latest-release] 130 131 132## 许可证 133[![FOSSA Status](https://app.fossa.io/api/projects/git%2Bgithub.com%2Faliyun%2Falibaba-cloud-sdk-go.svg?type=large)](https://app.fossa.io/projects/git%2Bgithub.com%2Faliyun%2Falibaba-cloud-sdk-go?ref=badge_large) 134 135[SDK]: https://github.com/aliyun/alibaba-cloud-sdk-go 136[apache]: http://www.apache.org/licenses/LICENSE-2.0 137[issue]: https://github.com/aliyun/alibaba-cloud-sdk-go/issues/new 138[open-api]: https://api.aliyun.com/ 139[latest-release]: https://github.com/aliyun/alibaba-cloud-sdk-go/releases 140[go]: https://golang.org/dl/ 141[endpoints]: https://developer.aliyun.com/endpoints 142[Requirements]: docs/0-Requirements-CN.md 143