对等连接
获取Endpoint
在确认您使用SDK配置Endpoint时,可先阅读开发人员指南中关于 VPC服务域名的部分,理解Endpoint相关的概念。 百度智能云目前开放了多区域支持,请参考区域选择说明中网络产品VPC的部分,对等连接服务是VPC服务的一部分,使用VPC服务域名。
获取AK/SK
要使用百度云产品,您需要拥有一个百度云账号和一个有效的 AK(Access Key ID)、SK(Secret Access Key)用来进行签名认证。可以通过如下步骤获得并了解您的AK/SK信息:
新建PeerConnClient
PeerConnClient是对等连接服务的客户端,为开发者与对等连接服务进行交互提供了一系列的方法。新建PeerConnClient时,需要先使用Endpoint、AK、SK对PeerConnClientConfiguration类型的config实例进行配置,再使用config实例对PeerConnClient进行配置,具体配置方法如下:
1static final String HOST = "";
2static final String AK = "";
3static final String SK = "";
4PeerConnClientConfiguration config = new PeerConnClientConfiguration();
5config.setCredentials(new DefaultBceCredentials(ak, sk));
6config.setEndpoint(endpoint);
7PeerConnClient peerConnClient = new PeerConnClient(config);
创建对等连接
函数声明
1public CreatePeerConnResponse createPeerConn(CreatePeerConnRequest request) {
2 ......
3}
参数含义
请参考OpenAPI文档:创建对等连接请求参数
返回值
- 操作成功
1{
2 "metadata":具体信息参考附录metadata部分,
3 "peerConnId": "peerconn-9td54fmx143e"
4}
- 操作失败
操作失败返回异常列表参考:异常列表
示例代码
具体代码示例参考:ExampleCreatePeerConn.java
查询对等连接列表
函数声明
1public ListPeerConnResponse listPeerConn(ListPeerConnRequest request) {
2 ......
3}
参数含义
请参考OpenAPI文档:查询对等连接列表请求参数
返回值
- 操作成功
1{
2 "metadata":具体信息参考附录metadata部分,
3 "marker":"peerconn-9td54fmx143e",
4 "isTruncated": true,
5 "nextMarker": "peerconn-srbvvxmjn7ux",
6 "maxKeys": 1
7 "peerConns":[
8 {
9 "peerConnId":"peerconn-9td54fmx143e",
10 "role":"initiator",
11 "status":"active",
12 "bandwithInMbp":500,
13 "description":"peer_diff_account",
14 "localIfId":"qpif-ken2yc9j8x56",
15 "localIfName":"int-SpLVk25R",
16 "localVpcId":"vpc-13vuxu016dew",
17 "localRegion":"bj",
18 "peerVpcId":"vpc-jcvmhw9h1a35",
19 "peerRegion":"bj",
20 "peerAccountId":"75c14a239bb24b9e88b695e8e9e47952",
21 "dnsStatus":"close",
22 "paymentTiming":"Postpaid",
23 "createdTime" :"2018-08-07 19:46:55",
24 "expiredTime":expiredTime
25 }
26 ]
27}
- 操作失败
操作失败返回异常列表参考:异常列表
示例代码
具体代码示例参考:ExampleListPeerConn.java
查询对等连接详情
函数声明
1public GetPeerConnResponse getPeerConn(GetPeerConnRequest request) {
2 ......
3}
参数含义
请参考OpenAPI文档:查询对等连接详情请求参数
返回值
- 操作成功
1{
2 "metadata":具体信息参考附录metadata部分,
3 "peerConnId":"peerconn-cbp4xrtzk3fb",
4 "role":"initiator",
5 "status":"active",
6 "bandwithInMbp":1000,
7 "description":"mypeerconn",
8 "localIfId":"qpif-qz9a61ujsizt",
9 "localIfName":"dsds",
10 "localVpcId":"20fada00-f66e-40de-bed4-954af13dc0b2",
11 "localRegion":"bj",
12 "peerVpcId":"1aa1427d-92cf-45d0-bc31-ab4d9fe71425",
13 "peerRegion":"bj",
14 "peerAccountId":"75c14a239bb24b9e88b695e8e9e47952",
15 "createdTime": "2018-08-03 20:38:43"
16 "expiredTime":null,
17 "dnsStatus":"close",
18 "paymentTiming":"Postpaid",
19 "tags":[
20 {
21 "tagKey": "tagKey",
22 "tagValue": "tagValue"
23 }
24 ]
25}
- 操作失败
操作失败返回异常列表参考:异常列表
示例代码
具体代码示例参考:ExampleGetPeerConn.java
更新对等连接本端接口名称和备注
函数声明
1public void modifyPeerConn(ModifyPeerConnRequest request) {
2 ......
3}
参数含义
请参考OpenAPI文档:更新对等连接本端接口名称和备注请求参数
返回值
- 操作成功
无返回值
- 操作失败
操作失败返回异常列表参考:异常列表
示例代码
具体代码示例参考:ExampleModifyPeerConn.java
处理对等连接申请
函数声明
1// 接收对等连接申请
2public void accept(PeerConnIdRequest request) {
3 ......
4}
5// 拒绝对等连接申请
6public void reject(PeerConnIdRequest request) {
7 ......
8}
参数含义
请参考OpenAPI文档:处理对等连接申请请求参数
返回值
- 操作成功
无返回值
- 操作失败
操作失败返回异常列表参考:异常列表
示例代码
具体代码示例参考:ExampleProcessPeerConnApply.java
释放对等连接
函数声明
1public void release(PeerConnIdRequest request) {
2 ......
3}
参数含义
请参考OpenAPI文档:释放对等连接请求参数
返回值
- 操作成功
无返回值
- 操作失败
操作失败返回异常列表参考:异常列表
示例代码
具体代码示例参考:ExampleDeletePeerConn.java
对等连接带宽升降级
函数声明
1public void modifyBandwith(ModifyBandwidthRequest request) {
2 ......
3}
参数含义
请参考OpenAPI文档:对等连接带宽升降级请求参数
返回值
- 操作成功
无返回值
- 操作失败
操作失败返回异常列表参考:异常列表
示例代码
具体代码示例参考:ExampleModifyBandwith.java
对等连接续费
函数声明
1public void purchaseReserved(PurchaseReservedPeerConnRequest request) {
2 ......
3}
参数含义
请参考OpenAPI文档:对等连接续费请求参数
返回值
- 操作成功
无返回值
- 操作失败
操作失败返回异常列表参考:异常列表
示例代码
具体代码示例参考:ExamplePurchaseReserved.java
开启对等连接同步DNS
函数声明
1public void openSyncDns(SyncDnsRequest request) {
2 ......
3}
参数含义
请参考OpenAPI文档:开启对等连接同步DNS请求参数
返回值
- 操作成功
无返回值
- 操作失败
操作失败返回异常列表参考:异常列表
示例代码
具体代码示例参考:ExampleOpenSyncDns.java
关闭对等连接同步DNS
函数声明
1public void closeSyncDns(SyncDnsRequest request) {
2 ......
3}
参数含义
请参考OpenAPI文档:关闭对等连接同步DNS请求参数
返回值
- 操作成功
无返回值
- 操作失败
操作失败返回异常列表参考:异常列表
示例代码
具体代码示例参考:ExampleCloseSyncDns.java
附录
公共返回信息metadata格式
1 {
2 "bceRequestId":"f5f0821d-45fe-439b-bbf4-fc48b639f84a",
3 "contentLength":28,
4 "contentType":"application/json;charset=UTF-8",
5 "date":1701917695000,
6 "server":"openresty/1.15.8.1"
7 }