Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/aliyun/alibaba-cloud-sdk-go

Alibaba Cloud SDK for Go
https://github.com/aliyun/alibaba-cloud-sdk-go

alibaba alibaba-cloud aliyun dns ecs go rds sdk slb

Last synced: 4 days ago
JSON representation

Alibaba Cloud SDK for Go

Host: GitHub
URL: https://github.com/aliyun/alibaba-cloud-sdk-go
Owner: aliyun
License: apache-2.0
Created: 2017-11-21T11:32:54.000Z (about 7 years ago)
Default Branch: master
Last Pushed: 2024-04-30T15:15:53.000Z (9 months ago)
Last Synced: 2024-05-05T03:52:16.743Z (9 months ago)
Topics: alibaba, alibaba-cloud, aliyun, dns, ecs, go, rds, sdk, slb
Language: Go
Homepage:
Size: 37.7 MB
Stars: 1,146
Watchers: 36
Forks: 266
Open Issues: 32
Metadata Files:
- Readme: README-CN.md
- Changelog: ChangeLog.txt
- Contributing: CONTRIBUTING.md
- License: LICENSE

Awesome Lists containing this project

awesome-golang-repositories - alibaba-cloud-sdk-go
awesome-alibaba-cloud - Go Lang SDK

README

        [English](./README.md) | 简体中文 | [日本語](README-JP.md)







Alibaba Cloud SDK for Go


[![Go](https://github.com/aliyun/alibaba-cloud-sdk-go/actions/workflows/go.yml/badge.svg)](https://github.com/aliyun/alibaba-cloud-sdk-go/actions/workflows/go.yml)

[![codecov](https://codecov.io/gh/aliyun/alibaba-cloud-sdk-go/graph/badge.svg?token=kHbylWc7aV)](https://codecov.io/gh/aliyun/alibaba-cloud-sdk-go)

[![FOSSA Status](https://app.fossa.io/api/projects/git%2Bgithub.com%2Faliyun%2Falibaba-cloud-sdk-go.svg?type=shield&issueType=license)](https://app.fossa.io/projects/git%2Bgithub.com%2Faliyun%2Falibaba-cloud-sdk-go?ref=badge_shield&issueType=license)

欢迎使用 Alibaba Cloud SDK for Go。Alibaba Cloud SDK for Go 让您不用复杂编程即可访问云服务器、云监控等多个阿里云服务。

这里向您介绍如何获取 [Alibaba Cloud SDK for Go][SDK] 并开始调用。

## 使用诊断

[Troubleshoot](https://api.aliyun.com/troubleshoot?source=github_sdk) 提供 OpenAPI 使用诊断服务，通过 `RequestID` 或 `报错信息` ，帮助开发者快速定位，为开发者提供解决方案。

## 在线示例

[阿里云 OpenAPI 开发者门户][open-api-portal] 提供在线调用阿里云产品，并动态生成 SDK 代码和快速检索接口等能力，能显著降低使用云 API 的难度。

## 环境要求

- 您的系统需要达到 [环境要求][Requirements], 例如，安装了不低于 1.13.x 版本的 Go 环境。

## 安装

使用 `go get` 下载安装 SDK

```sh

go get -u github.com/aliyun/alibaba-cloud-sdk-go/sdk

```

## 快速使用

在您开始之前，您需要注册阿里云帐户并获取您的[凭证](https://usercenter.console.aliyun.com/#/manage/ak)。

### 创建客户端

```go

package main

import "github.com/aliyun/alibaba-cloud-sdk-go/sdk"

func main() {

  client, err := sdk.NewClientWithAccessKey("REGION_ID", "ACCESS_KEY_ID", "ACCESS_KEY_SECRET")

  if err != nil {

    // Handle exceptions

    panic(err)

  }

}

```

### ROA 请求

```go

package main

import "github.com/aliyun/alibaba-cloud-sdk-go/sdk/requests"

func main() {

  request := requests.NewCommonRequest()        // 构造一个公共请求

  request.Method = "GET"                        // 设置请求方式

  request.Product = "CS"                        // 指定产品

  request.Domain = "cs.aliyuncs.com"            // 指定域名则不会寻址，如认证方式为 Bearer Token 的服务则需要指定

  request.Version = "2015-12-15"                // 指定产品版本

  request.PathPattern = "/clusters/[ClusterId]" // 指定ROA风格路径规则

  request.ApiName = "DescribeCluster"           // 指定接口名

  request.QueryParams["ClusterId"] = "123456"   // 设置参数值

  request.QueryParams["RegionId"] = "region_id" // 指定请求的区域，不指定则使用客户端区域、默认区域

  request.TransToAcsRequest()                   // 把公共请求转化为acs请求

}

```

### RPC 请求

```go

package main

import "github.com/aliyun/alibaba-cloud-sdk-go/sdk/requests"

func main() {

  request := requests.NewCommonRequest()                // 构造一个公共请求

  request.Method = "POST"                               // 设置请求方式

  request.Product = "Ecs"                               // 指定产品

  request.Domain = "ecs.aliyuncs.com"                   // 指定域名则不会寻址，如认证方式为 Bearer Token 的服务则需要指定

  request.Version = "2014-05-26"                        // 指定产品版本

  request.ApiName = "CreateInstance"                    // 指定接口名

  request.QueryParams["InstanceType"] = "ecs.g5.large"  // 设置参数值

  request.QueryParams["RegionId"] = "region_id"         // 指定请求的区域，不指定则使用客户端区域、默认区域

  request.TransToAcsRequest()                           // 把公共请求转化为acs请求

}

```

## 文档

- [Requirements](docs/0-Requirements-CN.md)

- [Installation](docs/1-Installation-CN.md)

- [Client & Credentials](docs/2-Client-CN.md)

- [SSL Verify](docs/3-Verify-CN.md)

- [Proxy](docs/4-Proxy-CN.md)

- [Timeout](docs/5-Timeout-CN.md)

- [Debug](docs/6-Debug-CN.md)

- [Logger](docs/7-Logger-CN.md)

- [Concurrent](docs/8-Concurrent-CN.md)

- [Asynchronous Call](docs/9-Asynchronous-CN.md)

- [Package Management](docs/10-Package-Management-CN.md)

- [Endpoint](docs/11-Endpoint-CN.md)

## 问题

[提交 Issue][issue] 不符合指南的问题可能会立即关闭。

## 贡献

提交 Pull Request 之前请阅读[贡献指南](CONTRIBUTING.md)。

## 相关

- [阿里云服务 Regions & Endpoints][endpoints]

- [阿里云 OpenAPI 开发者门户][open-api-portal]

- [Go][go]

- [最新发行版本][latest-release]

## 许可证

[![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)

[SDK]: https://github.com/aliyun/alibaba-cloud-sdk-go

[issue]: https://github.com/aliyun/alibaba-cloud-sdk-go/issues/new

[open-api-portal]: https://next.api.aliyun.com/

[latest-release]: https://github.com/aliyun/alibaba-cloud-sdk-go/releases

[go]: https://golang.org/dl/

[endpoints]: https://developer.aliyun.com/endpoints

[Requirements]: docs/0-Requirements-CN.md