私有网络VPC

    对等连接

    获取Endpoint

    在确认您使用SDK配置Endpoint时,可先阅读开发人员指南中关于 VPC服务域名的部分,理解Endpoint相关的概念。 百度智能云目前开放了多区域支持,请参考区域选择说明中网络产品VPC的部分,对等连接服务是VPC服务的一部分,使用VPC服务域名。

    获取密钥

    要使用百度云产品,您需要拥有一个百度云账号和一个有效的 AK(Access Key ID)、SK(Secret Access Key)用来进行签名认证。可以通过如下步骤获得并了解您的AK/SK信息: 1. 注册百度云账号 2. 创建AK/SK

    PeerConnClient

    PeerConnClient将对等连接服务的API进行封装,简化了开发者与对等连接服务的交互,用户可调用PeerConnClient中的方法对对等连接进行配置。

    新建PeerConnClient

    新建PeerConnClient时,需要先使用Endpoint、AK、SK对BceClientConfiguration类型config实例进行配置,再使用config实例对PeerConnClient进行配置,具体配置方法如下:

    static final String HOST = "";
     static final String AK = "";
     static final String SK = "";
     PeerConnClientConfiguration config = new PeerConnClientConfiguration();
     config.setCredentials(new DefaultBceCredentials(AK, SK));
     config.setEndpoint(HOST);
     PeerConnClient peerConnClient = new PeerConnClient(config);

    创建对等连接

    创建对等连接时,需注意:

    • 对于同账号的对等连接,系统会触发对端自动接受。
    • 跨账号的对等连接,必须接受端接受后对等连接才可用。
    • 对于本端区域和对端区域相同的对等连接,billing参数只支持后付费(需要传billing参数,但是计费账单为0)。
    • 任意两个VPC之间最多只能存在一条对等连接。
    • 发起端和接收端的VPC不能是同一个。
    • 如果本端vpc和对端vpc均为中继vpc,则不可以建立对等连接。

    可以使用createPeerConn函数在制定VPC内创建对等连接,函数定义如下:

    public CreatePeerConnResponse createPeerConn(CreatePeerConnRequest request) 

    其中CreatePeerConnResponse、CreatePeerConnRequest定义见peerconn/model/ 参数说明如下:

    参数名称 类型 是否必需 描述
    bandwidthInMbps int 对等连接最大带宽,单位mbps
    localVpcId String 本端VPC ID
    peerVpcId String 对端VPC ID
    peerRegion String 对端地域
    description String 描述
    localIfName String 本端接口名称
    peerAccountId String 对端账号ID
    peerIfName String 对端接口名称
    billing 自定义Billing类型 计费方式,支持后付费以及按月预付费购买,详见计费说明

    其中自定义Billing类型定义见Billing.java 地域参数如下:

    名称 取值
    北京 bj
    广州 gz
    苏州 su
    上海 fsh
    香港 hkg
    保定 bd
    度小满金融专区 hb-fsg
    武汉 fwh
    新加坡 sin
    度小满金融专区二 bjfsg

    查询对等连接列表

    可以使用listPeerConn函数查询对等连接列表,函数定义如下:

    public ListPeerConnResponse listPeerConn(ListPeerConnRequest request)

    其中ListPeerConnResponse、ListPeerConnRequest定义见peerconn/model/

    参数说明如下:

    参数名称 类型 是否必需 描述
    vpcId String 对等连接VPC的ID
    marker String 批量获取列表的查询的起始位置
    maxKeys int 每页包含的最大数量,最大数量不超过1000。缺省值为1000

    查询对等连接详情

    可以使用getPeerConn函数查询对等连接详情,函数定义如下:

    public GetPeerConnResponse getPeerConn(GetPeerConnRequest request)

    其中GetPeerConnResponse、GetPeerConnRequest定义见peerconn/model/

    参数说明如下:

    参数名称 类型 是否必需 描述
    peerConnId String 对等连接的ID

    更新对等连接本端接口名称和备注

    可以使用modifyPeerConn函数更新对等连接,函数定义如下:

    public void modifyPeerConn(ModifyPeerConnRequest request)

    其中ModifyPeerConnRequest定义见peerconn/model/

    参数说明如下:

    参数名称 类型 是否必需 描述
    peerConnId String 对等连接的ID
    localIfId String 本端接口ID
    description String 描述
    localIfName String 本端接口名称

    处理对等连接申请

    • 发起端发出的连接请求超时时间为7天,超时后发起端对等连接的状态为协商失败。
    • 接收端拒绝后,发起端对等连接状态为协商失败。

    可以使用accept函数接受对等连接,函数定义如下:

    public void accept(PeerConnIdRequest request)

    可以使用reject函数拒绝对等连接,函数定义如下:

    public void reject(PeerConnIdRequest request)

    其中PeerConnIdRequest定义见peerconn/model/

    参数说明如下:

    参数名称 类型 是否必需 描述
    peerConnId String 对等连接的ID

    释放对等连接

    可以使用release函数释放对等连接,函数定义如下:

    public void release(PeerConnIdRequest request)

    其中PeerConnIdRequest定义见peerconn/model/

    参数说明如下:

    参数名称 类型 是否必需 描述
    peerConnId String 对等连接的ID

    对等连接带宽升降级

    可以使用modifyBandwith函数释放对等连接,函数定义如下:

    public void modifyBandwith(ModifyBandwidthRequest request)

    其中ModifyBandwidthRequest定义见peerconn/model/

    参数说明如下:

    参数名称 类型 是否必需 描述
    peerConnId String 对等连接的ID
    bandwidthInMbps int 对等连接最大带宽,单位mbps

    对等连接续费

    • 后付费的对等连接不能续费。
    • 跨账号续费操作只能由发起端来操作。

    可以使用purchaseReserved函数释放对等连接,函数定义如下:

    public void purchaseReserved(PurchaseReservedPeerConnRequest request)

    其中PurchaseReservedPeerConnRequest定义见peerconn/model/

    参数说明如下:

    参数名称 类型 是否必需 描述
    peerConnId String 对等连接的ID
    billing 自定义Billing类型 计费方式,详见计费说明

    其中自定义Billing类型定义见Billing.java

    开启对等连接同步DNS

    • 对等连接的状态为可用的时候才能开启DNS。
    • 对等连接的DNS状态为同步中或同步关闭中不可开启同步DNS。

    可以使用openSyncDns函数释放对等连接,函数定义如下:

    public void openSyncDns(SyncDnsRequest request)

    其中SyncDnsRequest定义见peerconn/model/

    参数说明如下:

    参数名称 类型 是否必需 描述
    peerConnId String 对等连接的ID
    role String 发起端"initiator" 接收端"acceptor"

    关闭对等连接同步DNS

    • 对等连接的状态为可用的时候才能关闭DNS。
    • 对等连接的DNS状态为同步中或同步关闭中不可关闭同步DNS。

    可以使用close_peerconn_dns_sync函数释放对等连接,函数定义如下:

     public void closeSyncDns(SyncDnsRequest request) 

    其中SyncDnsRequest定义见peerconn/model/

    参数说明如下:

    参数名称 类型 是否必需 描述
    peerConnId String 对等连接的ID
    role String 发起端"initiator" 接收端"acceptor"
    上一篇
    NAT
    下一篇
    版本说明