版本说明

本示例配套的SDK版本为：3.1.11及以上版本

示例简介

本示例展示如何使用云专线（DirectConnection）相关SDK

功能介绍

云专线虚拟接口增、删、改、查功能

前置条件

1.已 注册 华为云，并完成 实名认证

2.获取华为云开发工具包（SDK），您也可以查看安装JAVA SDK。

3.已获取华为云账号对应的Access Key（AK）和Secret Access Key（SK）。请在华为云控制台“我的凭证 > 访问密钥”页面上创建和查看您的AK/SK。具体请参见 访问密钥 。

4.已具备开发环境 ，支持Java JDK 1.8及其以上版本。

5.虚拟接口的创建 ，需要提前准备好物理连接和虚拟网关。

SDK获取和安装

您可以通过Maven配置所依赖的云专线服务SDK

具体的SDK版本号请参见 SDK开发中心 (产品类别：云专线)

代码示例

以下代码展示如何使用云专线（DirectConnection）相关SDK

                    
                    Copied!
                
import com.huaweicloud.sdk.core.auth.BasicCredentials;
import com.huaweicloud.sdk.core.exception.ClientRequestException;
import com.huaweicloud.sdk.core.exception.ServerResponseException;
import com.huaweicloud.sdk.dc.v3.DcClient;
import com.huaweicloud.sdk.dc.v3.model.CreateVirtualInterface;
import com.huaweicloud.sdk.dc.v3.model.CreateVirtualInterfaceRequest;
import com.huaweicloud.sdk.dc.v3.model.CreateVirtualInterfaceRequestBody;
import com.huaweicloud.sdk.dc.v3.model.CreateVirtualInterfaceResponse;
import com.huaweicloud.sdk.dc.v3.model.DeleteVirtualInterfaceRequest;
import com.huaweicloud.sdk.dc.v3.model.DeleteVirtualInterfaceResponse;
import com.huaweicloud.sdk.dc.v3.model.ListVirtualInterfacesRequest;
import com.huaweicloud.sdk.dc.v3.model.ListVirtualInterfacesResponse;
import com.huaweicloud.sdk.dc.v3.model.ShowVirtualInterfaceRequest;
import com.huaweicloud.sdk.dc.v3.model.ShowVirtualInterfaceResponse;
import com.huaweicloud.sdk.dc.v3.model.UpdateVirtualInterface;
import com.huaweicloud.sdk.dc.v3.model.UpdateVirtualInterfaceRequest;
import com.huaweicloud.sdk.dc.v3.model.UpdateVirtualInterfaceRequestBody;
import com.huaweicloud.sdk.dc.v3.model.UpdateVirtualInterfaceResponse;
import com.huaweicloud.sdk.dc.v3.region.DcRegion;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

import java.util.Arrays;

public class VirtualInterfaceDemo {

    private static final Logger logger = LoggerFactory.getLogger(VirtualInterfaceDemo.class);
    // 认证用的ak和sk硬编码到代码中或者明文存储都有很大的安全风险，建议在配置文件或者环境变量中密文存放，使用时解密，确保安全；
    // 本示例以ak和sk保存在环境变量中来实现身份认证为例，运行示例前请先在本地环境中设置环境变量HUAWEICLOUD_SDK_AK和HUAWEICLOUD_SDK_SK。
    private static final String AK = System.getenv("HUAWEICLOUD_SDK_AK");
    private static final String SK = System.getenv("HUAWEICLOUD_SDK_SK");
    private static final String PROJECT_ID = "<your project id>";

    private static DcClient client = getDcClient();

    /* 获取DC请求客户端 */
    public static DcClient getDcClient() {
        return DcClient.newBuilder()
                .withCredential(new BasicCredentials()
                        .withAk(AK)
                        .withSk(SK)
                        .withProjectId(PROJECT_ID)
                ).withRegion(DcRegion.CN_NORTH_4)
                .build();
    }

    public static void main(String[] args) {

        // 1,创建虚拟接口
        CreateVirtualInterfaceResponse response = createVirtualInterface();

        // 2,查询虚拟接口详情
        showVirtualInterface(response.getVirtualInterface().getId());

        // 3,修改虚拟接口
        updateVirtualInterface(response.getVirtualInterface().getId());

        // 4,查询虚拟接口列表
        listVirtualInterfaces(response.getVirtualInterface().getId());

        // 5,删除虚拟接口
        deleteVirtualInterface(response.getVirtualInterface().getId());
    }

    private static CreateVirtualInterfaceResponse createVirtualInterface() {
        CreateVirtualInterface createVirtualInterface = new CreateVirtualInterface()
                .withName("<your virtual-interface name>")
                .withDescription("<your virtual-interface description>")
                .withDirectConnectId("<your direct-connect id>")
                .withType(CreateVirtualInterface.TypeEnum.valueOf("private"))
                .withServiceType(CreateVirtualInterface.ServiceTypeEnum.valueOf("vpc"))
                .withBandwidth(10)
                .withVlan(10)
                .withVgwId("<your virtual-gateway id>")
                .withRouteMode(CreateVirtualInterface.RouteModeEnum.valueOf("static"))
                .withLocalGatewayV4Ip("<your local-gateway-v4-ip>")
                .withRemoteGatewayV4Ip("<your remote-gateway-v4-ip>")
                .withRemoteEpGroup(Arrays.asList("<your remote-ep-group>"));
        CreateVirtualInterfaceRequest request = new CreateVirtualInterfaceRequest()
                .withBody(new CreateVirtualInterfaceRequestBody().withVirtualInterface(createVirtualInterface));
        CreateVirtualInterfaceResponse response = null;
        try {
            response = client.createVirtualInterface(request);
            logger.info(response.toString());
        } catch (ClientRequestException e) {
            logger.error(String.valueOf(e.getHttpStatusCode()));
            logger.error(e.toString());
        } catch (ServerResponseException e) {
            logger.error(String.valueOf(e.getHttpStatusCode()));
            logger.error(e.getMessage());
        }
        return response;
    }

    private static void showVirtualInterface(String virtualInterfaceId) {
        ShowVirtualInterfaceRequest request = new ShowVirtualInterfaceRequest().withVirtualInterfaceId(virtualInterfaceId);
        try {
            ShowVirtualInterfaceResponse response = client.showVirtualInterface(request);
            logger.info(response.toString());
        } catch (ClientRequestException e) {
            logger.error(String.valueOf(e.getHttpStatusCode()));
            logger.error(e.toString());
        } catch (ServerResponseException e) {
            logger.error(String.valueOf(e.getHttpStatusCode()));
            logger.error(e.getMessage());
        }
    }

    private static void updateVirtualInterface(String virtualInterfaceId) {
        UpdateVirtualInterfaceRequest request = new UpdateVirtualInterfaceRequest()
                .withVirtualInterfaceId(virtualInterfaceId)
                .withBody(new UpdateVirtualInterfaceRequestBody().withVirtualInterface(new UpdateVirtualInterface()
                        .withName("<your new virtual-interface name>")
                        .withDescription("<your new virtual-interface description>")));
        try {
            UpdateVirtualInterfaceResponse response = client.updateVirtualInterface(request);
            logger.info(response.toString());
        } catch (ClientRequestException e) {
            logger.error(String.valueOf(e.getHttpStatusCode()));
            logger.error(e.toString());
        } catch (ServerResponseException e) {
            logger.error(String.valueOf(e.getHttpStatusCode()));
            logger.error(e.getMessage());
        }
    }

    private static void listVirtualInterfaces(String virtualInterfaceId) {
        ListVirtualInterfacesRequest request = new ListVirtualInterfacesRequest().withId(Arrays.asList(virtualInterfaceId));
        try {
            ListVirtualInterfacesResponse response = client.listVirtualInterfaces(request);
            logger.info(response.toString());
        } catch (ClientRequestException e) {
            logger.error(String.valueOf(e.getHttpStatusCode()));
            logger.error(e.toString());
        } catch (ServerResponseException e) {
            logger.error(String.valueOf(e.getHttpStatusCode()));
            logger.error(e.getMessage());
        }
    }

    private static void deleteVirtualInterface(String virtualInterfaceId) {
        DeleteVirtualInterfaceRequest request = new DeleteVirtualInterfaceRequest().withVirtualInterfaceId(virtualInterfaceId);
        try {
            DeleteVirtualInterfaceResponse response = client.deleteVirtualInterface(request);
            logger.info(response.toString());
        } catch (ClientRequestException e) {
            logger.error(String.valueOf(e.getHttpStatusCode()));
            logger.error(e.toString());
        } catch (ServerResponseException e) {
            logger.error(String.valueOf(e.getHttpStatusCode()));
            logger.error(e.getMessage());
        }
    }
}

您可以在 云专线DC服务文档 和API Explorer 查看具体信息。

修订记录