README.md 6.5 KB
English | 简体中文
Alibaba Cloud Client for Go
Alibaba Cloud Client for Go is a client tool that helps Go developers manage credentials and send requests, Alibaba Cloud SDK for Go dependency on this tool.
Online Demo
API Explorer provides the ability to call the cloud product OpenAPI online, and dynamically generate SDK Example code and quick retrieval interface, which can significantly reduce the difficulty of using the cloud API.
Requirements
- It's necessary for you to make sure your system meet the [Requirements][Requirements], such as installing a Go environment which is new than 1.10.x.
Installation
Use go get to install SDK：
$ go get -u github.com/aliyun/alibaba-cloud-sdk-go/sdk
If you have used glide to manage dependence，you can also use glide to install Alibaba Cloud Go SDK：
$ glide get github.com/aliyun/alibaba-cloud-sdk-go
Quick Examples
Before you begin, you need to sign up for an Alibaba Cloud account and retrieve your Credentials.
Create Client
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 Request
package main
import "github.com/aliyun/alibaba-cloud-sdk-go/sdk/requests"
func main() {
request := requests.NewCommonRequest() // Make a common request
request.Method = "GET" // Set request method
request.Product = "CS" // Specify product
request.Domain = "cs.aliyuncs.com" // Location Service will not be enabled if the host is specified. For example, service with a Certification type-Bearer Token should be specified
request.Version = "2015-12-15" // Specify product version
request.PathPattern = "/clusters/[ClusterId]" // Specify path rule with ROA-style
request.Scheme = "https" // Set request scheme. Default: http
request.ApiName = "DescribeCluster" // Specify product interface
request.QueryParams["ClusterId"] = "123456" // Assign values to parameters in the path
request.QueryParams["RegionId"] = "region_id" // Specify the requested regionId, if not specified, use the client regionId, then default regionId
request.TransToAcsRequest() // Trans commonrequest to acsRequest, which is used by client.
}
RPC Request
package main
import "github.com/aliyun/alibaba-cloud-sdk-go/sdk/requests"
func main() {
request := requests.NewCommonRequest() // Make a common request
request.Method = "POST" // Set request method
request.Product = "Ecs" // Specify product
request.Domain = "ecs.aliyuncs.com" // Location Service will not be enabled if the host is specified. For example, service with a Certification type-Bearer Token should be specified
request.Version = "2014-05-26" // Specify product version
request.Scheme = "https" // Set request scheme. Default: http
request.ApiName = "CreateInstance" // Specify product interface
request.QueryParams["InstanceType"] = "ecs.g5.large" // Assign values to parameters in the path
request.QueryParams["RegionId"] = "region_id" // Specify the requested regionId, if not specified, use the client regionId, then default regionId
request.TransToAcsRequest() // Trans commonrequest to acsRequest, which is used by client.
}
Documentation
Issues
Opening an Issue, Issues not conforming to the guidelines may be closed immediately.
Contribution
Please make sure to read the Contributing Guide before making a pull request.
References
License
