文档中心

NAT网关

JAVA

Java安装指导

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

前提条件

您已注册火山引擎账号并完成实名认证，具体步骤，请参见账号注册及实名认证。

要使用火山引擎Java SDK访问指定服务的API ，请确认您已在火山引擎控制台开通当前服务。

您已获取账号的AccessKey，具体步骤，请参见获取AccessKey 。

您确认已安装Java JDK 1.7或以上版本，您可以下载最新版本： http://developers.sun.com/downloads/。

SDK下载地址

Java SDK下载地址：volcengine-java-sdk

安装SDK

步骤一：设置字节跳动Maven镜像仓库（可选）

当SDK版本大于或者等于0.1.28时，volcengine-java-sdk会在Maven中央仓库发布，您可以无需执行本步骤。但字节跳动的Maven仓库更新时间会比Maven中央仓库提早几个小时，您也可以按需选用字节跳动的Maven仓库。

当SDK版本小于0.1.28时，volcengine-java-sdk并未在Maven中央仓库发布，而是在字节跳动对外的Maven仓库发布，因此您在使用前，请先在Maven的安装目录conf/settings.xml中，针对字节跳动的Maven仓库进行镜像设置，设置方法如下：

# 请将如下设置加入到 <mirror>标签中​
​
<mirror>​
     <id>bytedanceMaven</id>​
     <mirrorOf>my-repo-id</mirrorOf>​
     <name>字节跳动maven仓库</name>​
     <url>https://artifact.bytedance.com/repository/releases/</url>​
</mirror>​

步骤二：配置Maven项目依赖

新建一个Maven项目，在项目目录下的pom.xml中，添加如下设置，引入服务依赖。引入依赖后，Maven项目管理工具会自动下载相关jar包。

独立服务包

您可以按需引入服务依赖，以VPC、ECS、EBS服务为例，您需要引入volcengine-java-sdk-vpc、volcengine-java-sdk-ecs和volcengine-java-sdk-storageebs。

#
<dependencies>
<dependency>
<groupId>com.volcengine</groupId>
<artifactId>volcengine-java-sdk-vpc</artifactId>
<version>0.1.61</version>
</dependency>
<dependency>
<groupId>com.volcengine</groupId>
<artifactId>volcengine-java-sdk-ecs</artifactId>
<version>0.1.61</version>
</dependency>
<dependency>
<groupId>com.volcengine</groupId>
<artifactId>volcengine-java-sdk-storageebs</artifactId>
<version>0.1.61</version>
</dependency>
</dependencies>

全部SDK包

如果您需要引入SDK的全部服务，可以通过bom方式引入。如下文所示，引入volcengine-java-sdk-bom后，即可引入所有支持的服务：

<dependencyManagement>
<dependencies>
<dependency>
<groupId>com.volcengine</groupId>
<artifactId>volcengine-java-sdk-bom</artifactId>
<version>0.1.61</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>

使用Java SDK

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

新建TestNat.java文件，参考 DescribeNatGatewayAttributes 的请求参数说明，添加如下代码。

/**​
* Example Code generated by Beijing Volcanoengine Technology.​
*/​
package com.volcengine.natgateway.examples;​
​
import com.volcengine.ApiClient;​
import com.volcengine.ApiException;​
import com.volcengine.sign.Credentials;​
​
import com.volcengine.natgateway.NatgatewayApi;​
import com.volcengine.natgateway.model.*;​
​
​
public class TestDescribeNatGatewayAttributes {​
    public static void main(String[] args) throws Exception {​
        // 设置您的ak​
        String ak = "Your AK";​
        // 设置您的sk​
        String sk = "Your SK";​
        // 设置您要访问的地域，本示例为北京地域​
        String region = "cn-beijing";​
​
                          // 初始化apiclient​
        ApiClient apiClient = new ApiClient()​
                .setCredentials(Credentials.getCredentials(ak, sk))​
                .setRegion(region);​
​
        NatgatewayApi api = new NatgatewayApi(apiClient);​
        ​
        // 创建一个DescribeNatGatewayAttributes接口​
        DescribeNatGatewayAttributesRequest describeNatGatewayAttributesRequest = new DescribeNatGatewayAttributesRequest();​
        // 设置接口入参，本示例仅传入实例ID，即NatGatewayId​
        describeNatGatewayAttributesRequest.setNatGatewayId("ngw-2fesmko5zhdz459gp67sc****");​
​
        // 发起请求并处理返回或异常​
        try {​
            DescribeNatGatewayAttributesResponse response = api.describeNatGatewayAttributes(describeNatGatewayAttributesRequest);​
            System.out.println(response);​
        } catch (ApiException e) {​
            System.out.println(e.getResponseBody());​
        }​
    }​
}​

附录：关于Java JDK 9+的特殊说明

如果您的Java版本高于或者等于JDK 9，则需要依赖javax.annotation-api，请在pom.xml中添加如下内容：

<dependency>​
  <groupId>javax.annotation</groupId>​
  <artifactId>javax.annotation-api</artifactId>​
  <version>1.3.2</version>​
</dependency>​

最近更新时间：2025.07.23 16:22:01

这个页面对您有帮助吗？

有用

无用