Skip to content

Latest commit

 

History

History
137 lines (99 loc) · 5.35 KB

README-CN.md

File metadata and controls

137 lines (99 loc) · 5.35 KB

English | 简体中文 | 日本語

Alibaba Cloud SDK for Go

Go codecov FOSSA Status

欢迎使用 Alibaba Cloud SDK for Go。Alibaba Cloud SDK for Go 让您不用复杂编程即可访问云服务器、云监控等多个阿里云服务。 这里向您介绍如何获取 Alibaba Cloud SDK for Go 并开始调用。

使用诊断

Troubleshoot 提供 OpenAPI 使用诊断服务,通过 RequestID报错信息 ,帮助开发者快速定位,为开发者提供解决方案。

在线示例

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

环境要求

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

安装

使用 go get 下载安装 SDK

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

快速使用

在您开始之前,您需要注册阿里云帐户并获取您的凭证

创建客户端

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 请求

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 请求

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请求
}

文档

问题

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

贡献

提交 Pull Request 之前请阅读贡献指南

相关

许可证

FOSSA Status