本文以調用查詢一臺或多臺ECS實例的詳細信息（DescribeInstances）接口為例，為您介紹Go V2.0 SDK的安裝和使用。
前提條件
由于阿里云賬號（主賬號）擁有資源的所有權限，其AccessKey一旦泄露風險巨大，所以建議您使用滿足最小化權限需求的RAM用戶的AccessKey。具體操作方式請參見創建AccessKey。
給RAM用戶授予操作云服務器ECS相關資源的權限。本文提供的示例代碼為查詢示例，所以選擇AliyunECSReadonlyAccess系統權限策略，您在使用的時候可以根據業務需求進行自定義授權。
使用自定義權限策略。
關于如何創建自定義權限策略，請參見創建自定義權限策略和授權信息。
云服務器ECS依據最佳實踐提供了一些自定義權限策略示例，您可以參考這些示例以快速創建符合自身業務需求的自定義權限策略，具體詳情請參見云服務器ECS自定義權限策略參考。
使用系統權限策略。
云服務器ECS支持的所有系統權限策略及其對應的權限描述，請參見云服務器 ECS系統權限策略參考。
在環境變量中配置AccessKey，具體操作步驟請參見在Linux、macOS和Windows系統配置環境變量。
安裝SDK
Go V2.0 SDK安裝方式請參見SDK 中心。您可以直接復制下方提供的安裝命令在Terminal中執行，以完成ECS SDK的安裝：
go get github.com/alibabacloud-go/darabonba-openapi/v2/client
使用SDK
1. 初始化客戶端
阿里云SDK支持多種訪問憑據用于初始化客戶端，例如AccessKey和STS Token等，更多方式請參見管理訪問憑證。本示例以通過AccessKey初始化客戶端為例。
package main
import (
"os"
openapi "github.com/alibabacloud-go/darabonba-openapi/v2/client"
ecs20140526 "github.com/alibabacloud-go/ecs-20140526/v4/client"
"github.com/alibabacloud-go/tea/tea"
)
func CreateClient() (_result *ecs20140526.Client, _err error) {
config := &openapi.Config{
// 必填，請確保代碼運行環境設置了環境變量 ALIBABA_CLOUD_ACCESS_KEY_ID。
AccessKeyId: tea.String(os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_ID")),
// 必填，請確保代碼運行環境設置了環境變量 ALIBABA_CLOUD_ACCESS_KEY_SECRET。
AccessKeySecret: tea.String(os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET")),
}
// Endpoint 請參考 https://api.aliyun.com/product/Ecs
config.Endpoint = tea.String("ecs-cn-hangzhou.aliyuncs.com")
_result = &ecs20140526.Client{}
_result, _err = ecs20140526.NewClient(config)
return _result, _err
}
2. 構建接口的請求對象
在構建請求對象之前，請查看該接口的API文檔獲取參數信息。
請求對象命名規則：{API名稱}Request，例如DescribeInstances該接口的請求對象為DescribeInstancesRequest。
// 構造請求對象
describeInstancesRequest := &ecs20140526.DescribeInstancesRequest{
RegionId: tea.String("cn-hangzhou"),
}3. 發起調用
通過客戶端調用OpenAPI時，支持設置運行時參數，例如超時配置、代理配置等，更多信息請查看進階配置。
接口返回對象命名規則：{API名稱}Response，例如DescribeInstances該接口的返回對象為DescribeInstancesResponse。
// 設置運行時參數
runtime := &util.RuntimeOptions{}
// 調用 DescribeInstances 接口
response, _err := ecsClient.DescribeInstancesWithOptions(describeInstancesRequest, runtime)
if _err != nil {
panic(_err)
}
fmt.Println(response.Body.String())4. 異常處理
Go SDK將異常進行了細致的分類，主要劃分為以下幾種error：
error：非業務報錯的error，比如SDK源文件被修改導致的校驗error，解析失敗導致的error等。
SDKError：在SDK的請求中主要以業務報錯為主的error。
建議采取合理的措施來處理異常，比如合理地傳播異常、記錄日志、嘗試恢復等，以確保系統的健壯性和穩定性。
5. 完整示例
package main
import (
"fmt"
"os"
openapi "github.com/alibabacloud-go/darabonba-openapi/v2/client"
ecs20140526 "github.com/alibabacloud-go/ecs-20140526/v4/client"
util "github.com/alibabacloud-go/tea-utils/v2/service"
"github.com/alibabacloud-go/tea/tea"
)
func CreateClient() (_result *ecs20140526.Client, _err error) {
config := &openapi.Config{
// 必填，請確保代碼運行環境設置了環境變量 ALIBABA_CLOUD_ACCESS_KEY_ID。
AccessKeyId: tea.String(os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_ID")),
// 必填，請確保代碼運行環境設置了環境變量 ALIBABA_CLOUD_ACCESS_KEY_SECRET。
AccessKeySecret: tea.String(os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET")),
}
// Endpoint 請參考 https://api.aliyun.com/product/Ecs
config.Endpoint = tea.String("ecs-cn-hangzhou.aliyuncs.com")
_result = &ecs20140526.Client{}
_result, _err = ecs20140526.NewClient(config)
return _result, _err
}
func main() {
ecsClient, _err := CreateClient()
if _err != nil {
panic(_err)
}
// 構造請求對象
describeInstancesRequest := &ecs20140526.DescribeInstancesRequest{
RegionId: tea.String("cn-hangzhou"),
}
// 設置運行時參數
runtime := &util.RuntimeOptions{}
resp, tryErr := func() (response *ecs20140526.DescribeInstancesResponse, _e error) {
defer func() {
if r := tea.Recover(recover()); r != nil {
_e = r
}
}()
// 調用 DescribeInstances 接口
response, _err := ecsClient.DescribeInstancesWithOptions(describeInstancesRequest, runtime)
if _err != nil {
return nil, _err
}
return response, nil
}()
if tryErr != nil {
if sdkError, ok := tryErr.(*tea.SDKError); ok { // 使用類型斷言判斷 tryErr 是否為 *tea.SDKError 類型
// 此處僅做打印展示，請謹慎對待異常處理，在工程項目中切勿直接忽略異常。
fmt.Println(tea.StringValue(sdkError.Message))
fmt.Println(tea.StringValue(sdkError.Code))
fmt.Println(tea.StringValue(sdkError.Data))
} else {
// 此處僅做打印展示，請謹慎對待異常處理，在工程項目中切勿直接忽略異常。
fmt.Println(tea.String(tryErr.Error()))
}
} else {
fmt.Println(resp.Body)
}
}
場景化示例
更多內容
除了使用上述調用方式外，您還可以使用泛化調用方式調用ECS的OpenAPI，詳細介紹請參見泛化調用。
若您當前使用的是V1.0 SDK，并希望進一步了解V1.0 SDK的相關內容，請參見V1.0 Go SDK。