Golang安装指导

本文为您介绍火山引擎Golang 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

本文以查询指定VPN网关信息为例，为您介绍如何使用Golang SDK。
创建测试文件main.go，参考DescribeVpnGatewayAttributes的请求参数说明，添加如下代码。

package vpnexample

import (
	"fmt"

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

func DescribeVpnGatewayAttributes() {
	// 设置您的AK、SK和要访问的地域。
	ak, sk, region := "Your AK", "Your SK", "Region"
	config := volcengine.NewConfig().
		WithRegion(region).
		WithCredentials(credentials.NewStaticCredentials(ak, sk, ""))
	sess, err := session.NewSession(config)
	if err != nil {
		panic(err)
	}
	svc := vpn.New(sess)
	// 创建DescribeVpnGatewayAttributes接口。
	describeVpnGatewayAttributesInput := &vpn.DescribeVpnGatewayAttributesInput{
		VpnGatewayId: volcengine.String("vgw-12bfa2du7fojk17q7y1rk****"), // 待查询VPN网关的ID。
	}

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