Alibaba Cloud SDK:Alibaba Cloud SDK V1.0 for Go との統合

クラウドサービス SDK

クラウドサービスの SDK には、API 操作の呼び出しに必要なリクエストオブジェクトとレスポンスオブジェクトが含まれています。次の例は、Elastic Compute Service (ECS) の SDK をインストールする方法を示しています。ターミナルまたはコマンドラインインターフェイス ( CLI ) で、次のインストールコマンドを実行します。

go get github.com/aliyun/alibaba-cloud-sdk-go/services/ecs

Alibaba Cloud サービスの SDK V1.0 for Go は、github.com/aliyun/alibaba-cloud-sdk-go/services/${Service コード} の形式で命名されます。

SDK のコアライブラリ

SDK のコアライブラリには、クライアントオブジェクト、署名ロジック、およびエラー処理ロジックが含まれており、これらは API 操作の呼び出しに必要な情報です。汎用呼び出しを行うには、次のコマンドを実行します。

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

1. リクエストクライアントを初期化する

すべての API 操作は、SDK ライブラリによって提供されるクライアントオブジェクトを使用して呼び出されます。API 操作を呼び出す前に、リクエストクライアントを初期化する必要があります。この例では、リクエストクライアントは AccessKey ペアを使用して初期化されます。詳細については、「アクセス認証情報の管理」をご参照ください。

import (
	"os"

	"github.com/aliyun/alibaba-cloud-sdk-go/sdk"
	"github.com/aliyun/alibaba-cloud-sdk-go/sdk/auth/credentials"
	"github.com/aliyun/alibaba-cloud-sdk-go/services/ecs"
)

func main() {
	config := sdk.NewConfig()
	credential, err := credentials.NewStaticAKCredentialsProviderBuilder().
		WithAccessKeyId(os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_ID")).
		WithAccessKeySecret(os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET")).
		Build()
	if err != nil {
		panic(err)
	}
	// クラウドサービスクライアントを初期化します。
	ecsClient, err := ecs.NewClientWithOptions("cn-hangzhou", config, credential)
	if err != nil {
		panic(err)
	}
}

2. リクエストオブジェクトを作成する

SDK によって提供されるリクエストオブジェクトを使用して、リクエストパラメータをカプセル化できます。

// サンプルコードでは、Requests ライブラリが使用されています。そのため、ライブラリをインポートするには、"github.com/aliyun/alibaba-cloud-sdk-go/sdk/requests" を追加する必要があります。

// リクエストオブジェクトを作成します。
request := ecs.CreateDescribeInstancesRequest()
request.InstanceIds = "[\"i-bp1dXXXXXXXXXXXX\"]"
request.PageSize = requests.Integer("100")
request.PageNumber = requests.Integer("1")

3. API リクエストを開始する

手順 1 で構築したリクエストクライアントを使用して、API 操作を呼び出します。操作のリクエストパラメータは、手順 2 で作成したリクエストオブジェクトにカプセル化されています。

response, err := ecsClient.DescribeInstances(request)
if err != nil {
	panic(err)
}
fmt.Print(response.GetHttpContentString())