安裝SDK

在Terminal中執行以下命令安裝核心SDK。

go get github.com/alibabacloud-go/darabonba-openapi/v2/client

代碼示例

示例：調用RPC風格的API

以調用ECS的DescribeRegions接口為例，展示如何使用泛化調用方式。

package main

import (
	"fmt"
	"os"

	openapi "github.com/alibabacloud-go/darabonba-openapi/v2/client"
	openapiutil "github.com/alibabacloud-go/openapi-util/service"
	util "github.com/alibabacloud-go/tea-utils/v2/service"
	"github.com/alibabacloud-go/tea/tea"
)

func main() {
	// 從環境變量中獲取訪問密鑰ID和密鑰Secret
	config := &openapi.Config{
		AccessKeyId:     tea.String(os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_ID")),
		AccessKeySecret: tea.String(os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET")),
	}
	// 設置客戶端的服務接入點
	config.Endpoint = tea.String("ecs-cn-hangzhou.aliyuncs.com")
	// 初始化并返回客戶端實例
	client, err := openapi.NewClient(config)
	if err != nil {
		panic(err)
	}
	params := &openapi.Params{
		// 設置API的行動、版本和其他必要參數
		Action:      tea.String("DescribeRegions"),
		Version:     tea.String("2014-05-26"),
		Protocol:    tea.String("HTTPS"),
		Method:      tea.String("POST"),
		AuthType:    tea.String("AK"),
		Style:       tea.String("RPC"),
		Pathname:    tea.String("/"),
		ReqBodyType: tea.String("json"),
		BodyType:    tea.String("json"),
	}

	// 設置查詢參數
	query := map[string]interface{}{
		"InstanceChargeType": tea.String("PostPaid"),
	}
	// 設置運行時選項
	runtime := &util.RuntimeOptions{}
	// 創建API請求并設置參數
	request := &openapi.OpenApiRequest{
		Query: openapiutil.Query(query),
	}
	// 調用API并處理返回結果
	response, err := client.CallApi(params, request, runtime)
	if err != nil {
		panic(err)
	}
	// 返回值為Map類型，可從Map中獲得三類數據：body、headers、HTTP返回的狀態碼 statusCode。
	fmt.Println(response["body"])
}

示例：調用RESTful（ROA）風格的API

以調用容器服務查詢集群列表信息為例，展示如何使用泛化調用。

package main

import (
	"fmt"
	"os"

	openapi "github.com/alibabacloud-go/darabonba-openapi/v2/client"
	openapiutil "github.com/alibabacloud-go/openapi-util/service"
	util "github.com/alibabacloud-go/tea-utils/v2/service"
	"github.com/alibabacloud-go/tea/tea"
)

func main() {
	// 從環境變量中獲取訪問密鑰ID和密鑰Secret
	config := &openapi.Config{
		AccessKeyId:     tea.String(os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_ID")),
		AccessKeySecret: tea.String(os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET")),
	}
	// Endpoint 請參考 https://api.aliyun.com/product/CS
	config.Endpoint = tea.String("cs.cn-qingdao.aliyuncs.com")
	client, err := openapi.NewClient(config)
	if err != nil {
		panic(err)
	}
	params := &openapi.Params{
		// 接口名稱
		Action: tea.String("DescribeClustersV1"),
		// 接口版本
		Version: tea.String("2015-12-15"),
		// 接口協議
		Protocol: tea.String("HTTPS"),
		// 接口 HTTP 方法
		Method:   tea.String("GET"),
		AuthType: tea.String("AK"),
		Style:    tea.String("ROA"),
		// 接口 PATH
		Pathname: tea.String("/api/v1/clusters"),
		// 接口請求體內容格式
		ReqBodyType: tea.String("json"),
		// 接口響應體內容格式
		BodyType: tea.String("json"),
	}
	// 設置查詢參數
	queries := map[string]interface{}{}
	queries["name"] = tea.String("cluster-demo")
	request := &openapi.OpenApiRequest{
		Query: openapiutil.Query(queries),
	}
	// runtime options
	runtime := &util.RuntimeOptions{}
	// 返回值為 Map 類型，可從 Map 中獲得三類數據：響應體 body、響應頭 headers、HTTP 返回的狀態碼 statusCode。
	response, err := client.CallApi(params, request, runtime)
	if err != nil {
		panic(err)
	}
	fmt.Println(response["body"])
}