本文为您介绍火山引擎Go SDK的下载地址及安装方式。

前提条件

• 您已注册火山引擎账号并完成实名认证，具体步骤，请参见 账号注册 及 实名认证 。
• 要使用火山引擎Golang SDK访问指定服务的API ，请确认您已在 火山引擎控制台 开通当前服务。
• 您已获取账号的AccessKey，具体步骤，请参见 获取AccessKey 。
• 您确认已安装Go 1.12或以上版本，执行go version可以检查当前Go的版本信息。
• 推荐使用go mod的方式进行管理。

SDK下载地址

Golang SDK下载地址：volcengine-go-sdk 。

安装SDK

1. 新建一个Go项目，使用go mod作为软件依赖工具。

2. 在go.mod中设置服务依赖。

   说明

   请参考Github下载地址中的release tag替换以下命令中v1.0.19为最新版本。

   require github.com/volcengine/volcengine-go-sdk v1.0.19
   

使用Golang SDK

本文以查看指定NAT网关的信息为例，为您介绍如何使用Golang SDK。

创建测试文件main.go，参考 DescribeNatGatewayAttributes 的请求参数说明，添加如下代码。

// Example Code generated by Beijing Volcanoengine Technology.

package natgatewayexample

import (
	"fmt"

	"github.com/volcengine/volcengine-go-sdk/service/natgateway"
	"github.com/volcengine/volcengine-go-sdk/volcengine"
	"github.com/volcengine/volcengine-go-sdk/volcengine/credentials"
	"github.com/volcengine/volcengine-go-sdk/volcengine/session"
)

func DescribeNatGatewayAttributes() {
	// 设置您的ak、sk和需要访问的地域（本示例为北京）
	ak, sk, region := "Your AK", "Your SK", "cn-beijing"
	
	config := volcengine.NewConfig().
		WithRegion(region).
		WithCredentials(credentials.NewStaticCredentials(ak, sk, ""))
	sess, err := session.NewSession(config)
	if err != nil {
		panic(err)
	}
	
	svc := natgateway.New(sess)

	// 创建一个describeNatGatewayAttributes接口
	describeNatGatewayAttributesInput := &natgateway.DescribeNatGatewayAttributesInput{
		NatGatewayId: volcengine.String("ngw-2fesmko5zhdz459gp67sc****"), // NAT网关的ID
	}

	// 发起请求并处理返回或异常
	resp, err := svc.DescribeNatGatewayAttributes(describeNatGatewayAttributesInput)
	if err != nil {
		panic(err)
	}
	fmt.Println(resp)
}