专线

更新时间：2025-08-21

获取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进行配置，具体配置方法如下：

Plain Text

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);

申请物理专线

函数声明

Plain Text

1public ApplyForEtResponse applyForEt(ApplyForEtRequest request) {
2    ......
3}

参数含义

请参考OpenAPI文档：申请物理专线请求参数

返回值

操作成功

Plain Text

1{
2    "metadata":具体信息参考附录metadata部分,
3    "id": "dcphy-gq65bz9ip712"
4}

操作失败

操作失败返回异常列表参考：异常列表

示例代码

具体代码示例参考：ExampleApplyForEt.java

查询专线列表

函数声明

Plain Text

1public ListEtResponse listEts(ListEtRequest request) {
2    ......
3}

参数含义

请参考OpenAPI文档：查询专线列表请求参数

返回值

操作成功

Plain Text

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

查询网络探测详情

函数声明

Plain Text

1public Et getEtDetail(String etId) {
2    ......
3}

参数含义

请参考OpenAPI文档：查询专线详情请求参数

返回值

操作成功

Plain Text

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

更新物理专线

函数声明

Plain Text

1public void updateEt(UpdateEtRequest request) {
2    ......
3}

参数含义

请参考OpenAPI文档：更新物理专线请求参数

返回值

操作成功

无返回值

操作失败

操作失败返回异常列表参考：异常列表

示例代码

具体代码示例参考：ExampleUpdateEt.java

新建专线通道

函数声明

Plain Text

1public CreateEtChannelResponse createEtChannel(CreateEtChannelRequest request) {
2    ......
3}

参数含义

请参考OpenAPI文档：新建专线通道请求参数

返回值

操作成功

Plain Text

1{
2    "metadata":具体信息参考附录metadata部分,
3    "id": "vpnconn-ku4cxya6nisq"
4}

操作失败

操作失败返回异常列表参考：异常列表

示例代码

具体代码示例参考：ExampleCreateEtChannel.java

查询专线通道列表

函数声明

Plain Text

1public ListEtChannelsResponse listEtChannels(String etId) {
2    ......
3}

参数含义

请参考OpenAPI文档：查询专线通道列表请求参数

返回值

操作成功

Plain Text

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

重新提交专线通道

函数声明

Plain Text

1public void resubmitEtChannel(ResubmitEtChannelRequest request) {
2    ......
3}

参数含义

请参考OpenAPI文档：重新提交专线通道请求参数

返回值

操作成功

无返回值

操作失败

操作失败返回异常列表参考：异常列表

示例代码

具体代码示例参考：ExampleResubmitEtChannel.java

更新专线通道

函数声明

Plain Text

1public void updateEtChannel(UpdateEtChannelRequest request) {
2    ......
3}

参数含义

请参考OpenAPI文档：更新专线通道请求参数

返回值

操作成功

无返回值

操作失败

操作失败返回异常列表参考：异常列表

示例代码

具体代码示例参考：ExampleUpdateEtChannel.java

删除专线通道

函数声明

Plain Text

1public void deleteEtChannel(EtChannelIdRequest request) {
2    ......
3}

参数含义

请参考OpenAPI文档：删除专线通道请求参数

返回值

操作成功

无返回值

操作失败

操作失败返回异常列表参考：异常列表

示例代码

具体代码示例参考：ExampleDeleteEtChannel.java

打开专线通道的IPv6功能

函数声明

Plain Text

1public void enableEtChannelIpv6(EnableEtChannelIpv6Request request) {
2    ......
3}

参数含义

请参考OpenAPI文档：打开专线通道的IPv6功能请求参数

返回值

操作成功

无返回值

操作失败

操作失败返回异常列表参考：异常列表

示例代码

具体代码示例参考：ExampleEnableEtChannelIpv6.java

关闭专线通道的IPv6功能

函数声明

Plain Text

1public void disableEtChannelIpv6(EtChannelIdRequest request) {
2    ......
3}

参数含义

请参考OpenAPI文档：关闭专线通道的IPv6功能请求参数

返回值

操作成功

无返回值

操作失败

操作失败返回异常列表参考：异常列表

示例代码

具体代码示例参考：ExampleDisableEtChannelIpv6.java

新建专线通道路由规则

函数声明

Plain Text

1public CreateEtChannelRouteResponse createEtChannelRouteRule(CreateEtChannelRouteRuleRequest request) {
2    ......
3}

参数含义

请参考OpenAPI文档：新建专线通道路由规则请求参数

返回值

操作成功

Plain Text

1{
2    "metadata":具体信息参考附录metadata部分,
3    "routeRuleId": "dcrr-5afcf643-94e"
4}

操作失败

操作失败返回异常列表参考：异常列表

示例代码

具体代码示例参考：ExampleCreateEtChannelRouteRule.java

查询专线通道路由规则列表

函数声明

Plain Text

1public ListEtChannelRouteRulesResponse listEtChannelRouteRules(ListEtChannelRouteRulesRequest request) {
2    ......
3}

参数含义

请参考OpenAPI文档：查询专线通道路由规则列表请求参数

返回值

操作成功

Plain Text

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

修改专线通道路由规则

函数声明

Plain Text

1public void updateEtChannelRouteRule(UpdateEtChannelRouteRuleRequest request) {
2    ......
3}

参数含义

请参考OpenAPI文档：修改专线通道路由规则请求参数

返回值

操作成功

无返回值

操作失败

操作失败返回异常列表参考：异常列表

示例代码

具体代码示例参考：ExampleUpdateEtChannelRouteRule.java

删除专线通道路由规则

函数声明

Plain Text

1public void deleteEtRouteRule(EtChannelRouteRuleIdRequest request) {
2    ......
3}

参数含义

请参考OpenAPI文档：删除专线通道路由规则请求参数

返回值

操作成功

无返回值

操作失败

操作失败返回异常列表参考：异常列表

示例代码

具体代码示例参考：ExampleDeleteEtRouteRule.java

关联专线通道

函数声明

Plain Text

1public void associateEtChannel(AssociateEtChannelRequest request) {
2    ......
3}

参数含义

请参考OpenAPI文档：关联专线通道请求参数

返回值

操作成功

无返回值

操作失败

操作失败返回异常列表参考：异常列表

示例代码

具体代码示例参考：ExampleAssociateEtChannel.java

解关联专线通道

函数声明

Plain Text

1public void disassociateEtChannel(DisassociateEtChannelRequest request) {
2    ......
3}

参数含义

请参考OpenAPI文档：解关联专线通道请求参数

返回值

操作成功

无返回值

操作失败

操作失败返回异常列表参考：异常列表

示例代码

具体代码示例参考：ExampleDisassociateEtChannel.java

附录

公共返回信息metadata格式

Plain Text

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 }

异常处理

版本说明

专线 ET

专线 ET

专线

获取Endpoint

获取AK/SK

新建EtClient

申请物理专线

查询专线列表

查询网络探测详情

更新物理专线

新建专线通道

查询专线通道列表

重新提交专线通道

更新专线通道

删除专线通道

打开专线通道的IPv6功能

关闭专线通道的IPv6功能

新建专线通道路由规则

查询专线通道路由规则列表

修改专线通道路由规则

删除专线通道路由规则

关联专线通道

解关联专线通道

附录