专线
获取Endpoint
在确认您使用SDK配置Endpoint时,可先阅读开发人员指南中关于 ET服务域名的部分,理解Endpoint相关的概念。 百度智能云目前开放了多区域支持,请参考区域选择说明中网络产品ET的部分。
获取AK/SK
要使用百度云产品,您需要拥有一个百度云账号和一个有效的 AK(Access Key ID)、SK(Secret Access Key)用来进行签名认证。可以通过如下步骤获得并了解您的AK/SK信息:
新建EtClient
EtClient是专线服务的客户端,为开发者与专线服务进行交互提供了一系列的方法。新建EtClient时,需要先使用Endpoint、AK、SK对EtClientConfiguration类型的config实例进行配置,再使用config实例对EtClient进行配置,具体配置方法如下:
1static final String HOST = "";
2static final String AK = "";
3static final String SK = "";
4EtClientConfiguration config = new EtClientConfiguration();
5config.setCredentials(new DefaultBceCredentials(ak, sk));
6config.setEndpoint(endpoint);
7EtClient etClient = new EtClient(config);
申请物理专线
函数声明
1public ApplyForEtResponse applyForEt(ApplyForEtRequest request) {
2 ......
3}
参数含义
请参考OpenAPI文档:申请物理专线请求参数
返回值
- 操作成功
1{
2 "metadata":具体信息参考附录metadata部分,
3 "id": "dcphy-gq65bz9ip712"
4}
- 操作失败
操作失败返回异常列表参考:异常列表
示例代码
具体代码示例参考:ExampleApplyForEt.java
查询专线列表
函数声明
1public ListEtResponse listEts(ListEtRequest request) {
2 ......
3}
参数含义
请参考OpenAPI文档:查询专线列表请求参数
返回值
- 操作成功
1{
2 "metadata":具体信息参考附录metadata部分,
3 "nextMarker": "dcphy-gq65bz9ip712",
4 "marker": "dcphy-gq65bz9ie712",
5 "maxKeys": 1,
6 "isTruncated": true,
7 "ets": [{
8 "id": "dcphy-jy1sbnx32ez0",
9 "name": "et_6",
10 "description": "描述",
11 "status": "established",
12 "expireTime": "2019-01-30T08:50:00Z",
13 "isp": "ISP_CTC",
14 "intfType": "10G",
15 "apType": "BAIDU",
16 "apAddr": "BB",
17 "userName": "张三",
18 "userPhone": "133*****333",
19 "userEmail": "1***@123.com",
20 "userIdc": "北京|市辖区|东城区|2321"
21 }]
22}
- 操作失败
操作失败返回异常列表参考:异常列表
示例代码
具体代码示例参考:ExampleListEts.java
查询网络探测详情
函数声明
1public Et getEtDetail(String etId) {
2 ......
3}
参数含义
请参考OpenAPI文档:查询专线详情请求参数
返回值
- 操作成功
1{
2 "metadata":具体信息参考附录metadata部分,
3 "id": "dcphy-gq65bz9ip712",
4 "name": "ZX051501-testET",
5 "description": "",
6 "status": "established",
7 "expireTime": 1,
8 "isp": "ISP_CUCC",
9 "intfType": "10G",
10 "apType": "SINGLE",
11 "apAddr": "WHGG",
12 "userName": "张三",
13 "userPhone": "18218796578",
14 "userEmail": "shihuijuan@baidu.com",
15 "userIdc": "北京|市辖区|东城区|百度科技园K2"
16}
- 操作失败
操作失败返回异常列表参考:异常列表
示例代码
具体代码示例参考:ExampleGetEtDetail.java
更新物理专线
函数声明
1public void updateEt(UpdateEtRequest request) {
2 ......
3}
参数含义
请参考OpenAPI文档:更新物理专线请求参数
返回值
- 操作成功
无返回值
- 操作失败
操作失败返回异常列表参考:异常列表
示例代码
具体代码示例参考:ExampleUpdateEt.java
新建专线通道
函数声明
1public CreateEtChannelResponse createEtChannel(CreateEtChannelRequest request) {
2 ......
3}
参数含义
请参考OpenAPI文档:新建专线通道请求参数
返回值
- 操作成功
1{
2 "metadata":具体信息参考附录metadata部分,
3 "id": "vpnconn-ku4cxya6nisq"
4}
- 操作失败
操作失败返回异常列表参考:异常列表
示例代码
具体代码示例参考:ExampleCreateEtChannel.java
查询专线通道列表
函数声明
1public ListEtChannelsResponse listEtChannels(String etId) {
2 ......
3}
参数含义
请参考OpenAPI文档:查询专线通道列表请求参数
返回值
- 操作成功
1{
2 "metadata":具体信息参考附录metadata部分,
3 "etChannels": [
4 {
5 "authorizedUsers": [
6 "8770d0e94e2728ca81b0ec99db9f4df8"
7 ],
8 "description": "",
9 "baiduAddress": "11.11.11.21/24",
10 "name": "channel_name",
11 "bgpAsn": "45084",
12 "bgpKey": "7kab824",
13 "customerAddress": "11.11.11.12/24",
14 "routeType": "bgp",
15 "vlanId": 56
16 },
17 "id":"dedicatedconn-zy9t7n91k0iq",
18 "status":"building",
19 "enableIpv6": 1,
20 "baiduIpv6Address": "2400:da00:e003:0:1eb:200::1/88",
21 "customerIpv6Address": "2400:da00:e003:0:0:200::1/88"
22 ]
23}
- 操作失败
操作失败返回异常列表参考:异常列表
示例代码
具体代码示例参考:ExampleListEtChannels.java
重新提交专线通道
函数声明
1public void resubmitEtChannel(ResubmitEtChannelRequest request) {
2 ......
3}
参数含义
请参考OpenAPI文档:重新提交专线通道请求参数
返回值
- 操作成功
无返回值
- 操作失败
操作失败返回异常列表参考:异常列表
示例代码
具体代码示例参考:ExampleResubmitEtChannel.java
更新专线通道
函数声明
1public void updateEtChannel(UpdateEtChannelRequest request) {
2 ......
3}
参数含义
请参考OpenAPI文档:更新专线通道请求参数
返回值
- 操作成功
无返回值
- 操作失败
操作失败返回异常列表参考:异常列表
示例代码
具体代码示例参考:ExampleUpdateEtChannel.java
删除专线通道
函数声明
1public void deleteEtChannel(EtChannelIdRequest request) {
2 ......
3}
参数含义
请参考OpenAPI文档:删除专线通道请求参数
返回值
- 操作成功
无返回值
- 操作失败
操作失败返回异常列表参考:异常列表
示例代码
具体代码示例参考:ExampleDeleteEtChannel.java
打开专线通道的IPv6功能
函数声明
1public void enableEtChannelIpv6(EnableEtChannelIpv6Request request) {
2 ......
3}
参数含义
请参考OpenAPI文档:打开专线通道的IPv6功能请求参数
返回值
- 操作成功
无返回值
- 操作失败
操作失败返回异常列表参考:异常列表
示例代码
具体代码示例参考:ExampleEnableEtChannelIpv6.java
关闭专线通道的IPv6功能
函数声明
1public void disableEtChannelIpv6(EtChannelIdRequest request) {
2 ......
3}
参数含义
请参考OpenAPI文档:关闭专线通道的IPv6功能请求参数
返回值
- 操作成功
无返回值
- 操作失败
操作失败返回异常列表参考:异常列表
示例代码
具体代码示例参考:ExampleDisableEtChannelIpv6.java
新建专线通道路由规则
函数声明
1public CreateEtChannelRouteResponse createEtChannelRouteRule(CreateEtChannelRouteRuleRequest request) {
2 ......
3}
参数含义
请参考OpenAPI文档:新建专线通道路由规则请求参数
返回值
- 操作成功
1{
2 "metadata":具体信息参考附录metadata部分,
3 "routeRuleId": "dcrr-5afcf643-94e"
4}
- 操作失败
操作失败返回异常列表参考:异常列表
示例代码
具体代码示例参考:ExampleCreateEtChannelRouteRule.java
查询专线通道路由规则列表
函数声明
1public ListEtChannelRouteRulesResponse listEtChannelRouteRules(ListEtChannelRouteRulesRequest request) {
2 ......
3}
参数含义
请参考OpenAPI文档:查询专线通道路由规则列表请求参数
返回值
- 操作成功
1{
2 "metadata":具体信息参考附录metadata部分,
3 "nextMarker": "14eabc99-dce7-11ec-84d4-6c92bf29c398",
4 "maxKeys": 1,
5 "isTruncated": true,
6 "routeRules": [{
7 "routeRuleId": "dcrr-5afcf643-94e",
8 "ipVersion": 4,
9 "destAddress": "10.0.0.1/32",
10 "nexthopType": "etGateway"
11 "nexthopId": "dcgw-arc647h3014w",
12 "description": "route_1"
13 }]
14}
- 操作失败
操作失败返回异常列表参考:异常列表
示例代码
具体代码示例参考:ExampleListEtChannelRouteRules.java
修改专线通道路由规则
函数声明
1public void updateEtChannelRouteRule(UpdateEtChannelRouteRuleRequest request) {
2 ......
3}
参数含义
请参考OpenAPI文档:修改专线通道路由规则请求参数
返回值
- 操作成功
无返回值
- 操作失败
操作失败返回异常列表参考:异常列表
示例代码
具体代码示例参考:ExampleUpdateEtChannelRouteRule.java
删除专线通道路由规则
函数声明
1public void deleteEtRouteRule(EtChannelRouteRuleIdRequest request) {
2 ......
3}
参数含义
请参考OpenAPI文档:删除专线通道路由规则请求参数
返回值
- 操作成功
无返回值
- 操作失败
操作失败返回异常列表参考:异常列表
示例代码
具体代码示例参考:ExampleDeleteEtRouteRule.java
关联专线通道
函数声明
1public void associateEtChannel(AssociateEtChannelRequest request) {
2 ......
3}
参数含义
请参考OpenAPI文档:关联专线通道请求参数
返回值
- 操作成功
无返回值
- 操作失败
操作失败返回异常列表参考:异常列表
示例代码
具体代码示例参考:ExampleAssociateEtChannel.java
解关联专线通道
函数声明
1public void disassociateEtChannel(DisassociateEtChannelRequest request) {
2 ......
3}
参数含义
请参考OpenAPI文档:解关联专线通道请求参数
返回值
- 操作成功
无返回值
- 操作失败
操作失败返回异常列表参考:异常列表
示例代码
具体代码示例参考:ExampleDisassociateEtChannel.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 }