# alibaba-cloud-sdk-go
**Repository Path**: aliyun/alibaba-cloud-sdk-go
## Basic Information
- **Project Name**: alibaba-cloud-sdk-go
- **Description**: The Alibaba Cloud V1.0 Go SDK has entered End-of-Support (March 1, 2025) and is no longer recommended for use.
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-05-08
- **Last Updated**: 2025-08-28
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
[English](./README.md) | 简体中文 | [日本語](README-JP.md)
Alibaba Cloud SDK for Go
[](https://github.com/aliyun/alibaba-cloud-sdk-go/actions/workflows/go.yml)
[](https://codecov.io/gh/aliyun/alibaba-cloud-sdk-go)
[](https://app.fossa.io/projects/git%2Bgithub.com%2Faliyun%2Falibaba-cloud-sdk-go?ref=badge_shield&issueType=license)
阿里云 V1.0 Go SDK 已进入终止支持状态（2025年3月1日），不再建议使用。新用户请直接使用 V2.0 Go SDK；已经集成 V1.0 Go SDK 的用户也建议迁移至 V2.0 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]
## 许可证
[](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