对等连接
获取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进行配置,具体配置方法如下:
static final String HOST = "";
static final String AK = "";
static final String SK = "";
PeerConnClientConfiguration config = new PeerConnClientConfiguration();
config.setCredentials(new DefaultBceCredentials(ak, sk));
config.setEndpoint(endpoint);
PeerConnClient peerConnClient = new PeerConnClient(config);
创建对等连接
函数声明
public CreatePeerConnResponse createPeerConn(CreatePeerConnRequest request) {
......
}
参数含义
请参考OpenAPI文档:创建对等连接请求参数
返回值
- 操作成功
{
"metadata":具体信息参考附录metadata部分,
"peerConnId": "peerconn-9td54fmx143e"
}
- 操作失败
操作失败返回异常列表参考:异常列表
示例代码
具体代码示例参考:ExampleCreatePeerConn.java
查询对等连接列表
函数声明
public ListPeerConnResponse listPeerConn(ListPeerConnRequest request) {
......
}
参数含义
请参考OpenAPI文档:查询对等连接列表请求参数
返回值
- 操作成功
{
"metadata":具体信息参考附录metadata部分,
"marker":"peerconn-9td54fmx143e",
"isTruncated": true,
"nextMarker": "peerconn-srbvvxmjn7ux",
"maxKeys": 1
"peerConns":[
{
"peerConnId":"peerconn-9td54fmx143e",
"role":"initiator",
"status":"active",
"bandwithInMbp":500,
"description":"peer_diff_account",
"localIfId":"qpif-ken2yc9j8x56",
"localIfName":"int-SpLVk25R",
"localVpcId":"vpc-13vuxu016dew",
"localRegion":"bj",
"peerVpcId":"vpc-jcvmhw9h1a35",
"peerRegion":"bj",
"peerAccountId":"75c14a239bb24b9e88b695e8e9e47952",
"dnsStatus":"close",
"paymentTiming":"Postpaid",
"createdTime" :"2018-08-07 19:46:55",
"expiredTime":expiredTime
}
]
}
- 操作失败
操作失败返回异常列表参考:异常列表
示例代码
具体代码示例参考:ExampleListPeerConn.java
查询对等连接详情
函数声明
public GetPeerConnResponse getPeerConn(GetPeerConnRequest request) {
......
}
参数含义
请参考OpenAPI文档:查询对等连接详情请求参数
返回值
- 操作成功
{
"metadata":具体信息参考附录metadata部分,
"peerConnId":"peerconn-cbp4xrtzk3fb",
"role":"initiator",
"status":"active",
"bandwithInMbp":1000,
"description":"mypeerconn",
"localIfId":"qpif-qz9a61ujsizt",
"localIfName":"dsds",
"localVpcId":"20fada00-f66e-40de-bed4-954af13dc0b2",
"localRegion":"bj",
"peerVpcId":"1aa1427d-92cf-45d0-bc31-ab4d9fe71425",
"peerRegion":"bj",
"peerAccountId":"75c14a239bb24b9e88b695e8e9e47952",
"createdTime": "2018-08-03 20:38:43"
"expiredTime":null,
"dnsStatus":"close",
"paymentTiming":"Postpaid",
"tags":[
{
"tagKey": "tagKey",
"tagValue": "tagValue"
}
]
}
- 操作失败
操作失败返回异常列表参考:异常列表
示例代码
具体代码示例参考:ExampleGetPeerConn.java
更新对等连接本端接口名称和备注
函数声明
public void modifyPeerConn(ModifyPeerConnRequest request) {
......
}
参数含义
请参考OpenAPI文档:更新对等连接本端接口名称和备注请求参数
返回值
- 操作成功
无返回值
- 操作失败
操作失败返回异常列表参考:异常列表
示例代码
具体代码示例参考:ExampleModifyPeerConn.java
处理对等连接申请
函数声明
// 接收对等连接申请
public void accept(PeerConnIdRequest request) {
......
}
// 拒绝对等连接申请
public void reject(PeerConnIdRequest request) {
......
}
参数含义
请参考OpenAPI文档:处理对等连接申请请求参数
返回值
- 操作成功
无返回值
- 操作失败
操作失败返回异常列表参考:异常列表
示例代码
具体代码示例参考:ExampleProcessPeerConnApply.java
释放对等连接
函数声明
public void release(PeerConnIdRequest request) {
......
}
参数含义
请参考OpenAPI文档:释放对等连接请求参数
返回值
- 操作成功
无返回值
- 操作失败
操作失败返回异常列表参考:异常列表
示例代码
具体代码示例参考:ExampleDeletePeerConn.java
对等连接带宽升降级
函数声明
public void modifyBandwith(ModifyBandwidthRequest request) {
......
}
参数含义
请参考OpenAPI文档:对等连接带宽升降级请求参数
返回值
- 操作成功
无返回值
- 操作失败
操作失败返回异常列表参考:异常列表
示例代码
具体代码示例参考:ExampleModifyBandwith.java
对等连接续费
函数声明
public void purchaseReserved(PurchaseReservedPeerConnRequest request) {
......
}
参数含义
请参考OpenAPI文档:对等连接续费请求参数
返回值
- 操作成功
无返回值
- 操作失败
操作失败返回异常列表参考:异常列表
示例代码
具体代码示例参考:ExamplePurchaseReserved.java
开启对等连接同步DNS
函数声明
public void openSyncDns(SyncDnsRequest request) {
......
}
参数含义
请参考OpenAPI文档:开启对等连接同步DNS请求参数
返回值
- 操作成功
无返回值
- 操作失败
操作失败返回异常列表参考:异常列表
示例代码
具体代码示例参考:ExampleOpenSyncDns.java
关闭对等连接同步DNS
函数声明
public void closeSyncDns(SyncDnsRequest request) {
......
}
参数含义
请参考OpenAPI文档:关闭对等连接同步DNS请求参数
返回值
- 操作成功
无返回值
- 操作失败
操作失败返回异常列表参考:异常列表
示例代码
具体代码示例参考:ExampleCloseSyncDns.java
附录
公共返回信息metadata格式
{
"bceRequestId":"f5f0821d-45fe-439b-bbf4-fc48b639f84a",
"contentLength":28,
"contentType":"application/json;charset=UTF-8",
"date":1701917695000,
"server":"openresty/1.15.8.1"
}