使用火山引擎 Go SDK

本文档介绍如何使用 火山引擎 Go SDK 调用火山引擎私网解析（PrivateZone）的 API。

前提条件

• 您已经开通了私网解析 PrivateZone。参见 快速入门。
• 您使用的 Go 版本需要与 SDK 兼容。您可以参见 go.mod 了解 SDK 支持的 Go 版本。

获取 SDK

使用以下命令获取火山引擎 Go SDK。您需要根据您的 Go 版本选择不同的命令。

# Go 1.17 或更低版本
go get -u github.com/volcengine/volc-sdk-golang

# Go 1.18 或更高版本
go install github.com/volcengine/volc-sdk-golang@latest

实现步骤

1. 创建环境变量。

   • 创建名为 VOLC_ACCESSKEY 的环境变量，把 您的 Access Key ID 设置为环境变量的值。
   • 创建名为 VOLC_SECRETKEY 的环境变量，把 您的 Secret Access Key 设置为环境变量的值。

2. 调用 InitDNSVolcClient 方法初始化 SDK。

3. 调用 API。本文档以 ListRegions API 为例。

示例代码

实现步骤的示例代码如下：

package main

import (
	"context"
	"fmt"
	"os"

	pz "github.com/volcengine/volc-sdk-golang/service/privatezone"
)

func main() {
	// 创建环境变量
	// your_ak 是您的 Access Key ID
	// your_sk 是您的 Secret Access Key
	os.Setenv("VOLC_ACCESSKEY", "your_ak")
	os.Setenv("VOLC_SECRETKEY", "your_sk")

	// 初始化 SDK
	client := pz.InitDNSVolcClient()

	// 调用 ListRegions API
	resp, err := client.ListRegions(context.Background(), &pz.ListRegionsRequest{})
	if err != nil {
		panic(err)
	}

	fmt.Println(resp)
}