泛化调用
阿里云SDK不仅支持使用云产品SDK提供的特化调用方式调用OpenAPI，还支持使用核心SDK提供的泛化调用方式调用OpenAPI，两种方式的不同请参见泛化调用与特化调用。本文将从获取API信息、安装SDK和代码示例来为您介绍如何使用泛化调用。
获取API信息
访问API文档选择云产品，例如选择云服务器ECS。
单击云服务器名称下面的获取元数据，在元数据中
info.style查看云产品支持的OpenAPI风格（RPC或者ROA）。
说明该位置获取的元数据中包含了云产品的所有API信息，如果您想要查看单个API的元数据，请查看步骤2。
选择将要调用的API，单击右上角获取元数据。
在元数据中，定义了API支持的网络协议、请求方式、参数及参数位置等信息。如下图所示的RunInstances元数据中：
支持的网络协议有HTTP和HTTPS，建议使用HTTPS。
支持的请求方式有GET和POST，两者请求方式调用结果无任何差异，但GET请求只支持 32 KB 以内的请求包，所以推荐使用POST请求。
支持的参数有RegionId、ImageId等，参数位置在query，表示参数是要拼接在请求URL后面，例如https://ecs.cn-beijing.aliyuncs.com/?ImageId=aliyun_2_1903_x64_20G_alibase_20231221.vhd&InstanceChargeType=PostPaid&InstanceType=ecs.e-c1m1.large&InternetChargeType=PayByTraffic&MinAmount=1&Password=test%401234&RegionId=cn-beijing&SecurityGroupId=sg-2zec0dm6qi66XXXXXXXX&SystemDisk.Category=cloud_essd&SystemDisk.Size=40&VSwitchId=vsw-2ze3aagwn397gXXXXXXXX。
说明元数据中其他支持的内容对签名无影响，这里暂不详细说明。更多元数据的信息，请参见元数据使用指南。
安装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"])
}