专线

更新时间：2024-01-11

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

static final String HOST = "";
static final String AK = "";
static final String SK = "";
EtClientConfiguration config = new EtClientConfiguration();
config.setCredentials(new DefaultBceCredentials(ak, sk));
config.setEndpoint(endpoint);
EtClient etClient = new EtClient(config);

申请物理专线

函数声明

public ApplyForEtResponse applyForEt(ApplyForEtRequest request) {
    ......
}

参数含义

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

返回值

操作成功

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

操作失败

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

示例代码

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

查询专线列表

函数声明

public ListEtResponse listEts(ListEtRequest request) {
    ......
}

参数含义

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

返回值

操作成功

{
    "metadata":具体信息参考附录metadata部分,
    "nextMarker": "dcphy-gq65bz9ip712",
    "marker": "dcphy-gq65bz9ie712",
    "maxKeys": 1,
    "isTruncated": true,
    "ets": [{
        "id": "dcphy-jy1sbnx32ez0",
        "name": "et_6",
        "description": "描述",
        "status": "established",
        "expireTime": "2019-01-30T08:50:00Z",
        "isp": "ISP_CTC",
        "intfType": "10G",
        "apType": "BAIDU",
        "apAddr": "BB",
        "userName": "张三",
        "userPhone": "133*****333",
        "userEmail": "1***@123.com",
        "userIdc": "北京|市辖区|东城区|2321"
    }]
}

操作失败

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

示例代码

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

查询网络探测详情

函数声明

public Et getEtDetail(String etId) {
    ......
}

参数含义

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

返回值

操作成功

{
    "metadata":具体信息参考附录metadata部分,
    "id": "dcphy-gq65bz9ip712",
    "name": "ZX051501-testET",
    "description": "",
    "status": "established",
    "expireTime": 1,
    "isp": "ISP_CUCC",
    "intfType": "10G",
    "apType": "SINGLE",
    "apAddr": "WHGG",
    "userName": "张三",
    "userPhone": "18218796578",
    "userEmail": "shihuijuan@baidu.com",
    "userIdc": "北京|市辖区|东城区|百度科技园K2"
}

操作失败

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

示例代码

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

更新物理专线

函数声明

public void updateEt(UpdateEtRequest request) {
    ......
}

参数含义

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

返回值

操作成功

无返回值

操作失败

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

示例代码

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

新建专线通道

函数声明

public CreateEtChannelResponse createEtChannel(CreateEtChannelRequest request) {
    ......
}

参数含义

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

返回值

操作成功

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

操作失败

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

示例代码

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

查询专线通道列表

函数声明

public ListEtChannelsResponse listEtChannels(String etId) {
    ......
}

参数含义

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

返回值

操作成功

{
    "metadata":具体信息参考附录metadata部分,
    "etChannels": [
        {
        "authorizedUsers": [
            "8770d0e94e2728ca81b0ec99db9f4df8"
        ],
        "description": "",
        "baiduAddress": "11.11.11.21/24",
        "name": "channel_name",
        "bgpAsn": "45084",
        "bgpKey": "7kab824",
        "customerAddress": "11.11.11.12/24",
        "routeType": "bgp",
        "vlanId": 56  
        },
        "id":"dedicatedconn-zy9t7n91k0iq",
        "status":"building",
        "enableIpv6": 1,
        "baiduIpv6Address": "2400:da00:e003:0:1eb:200::1/88",
        "customerIpv6Address": "2400:da00:e003:0:0:200::1/88"
    ]
}

操作失败

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

示例代码

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

重新提交专线通道

函数声明

public void resubmitEtChannel(ResubmitEtChannelRequest request) {
    ......
}

参数含义

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

返回值

操作成功

无返回值

操作失败

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

示例代码

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

更新专线通道

函数声明

public void updateEtChannel(UpdateEtChannelRequest request) {
    ......
}

参数含义

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

返回值

操作成功

无返回值

操作失败

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

示例代码

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

删除专线通道

函数声明

public void deleteEtChannel(EtChannelIdRequest request) {
    ......
}

参数含义

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

返回值

操作成功

无返回值

操作失败

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

示例代码

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

打开专线通道的IPv6功能

函数声明

public void enableEtChannelIpv6(EnableEtChannelIpv6Request request) {
    ......
}

参数含义

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

返回值

操作成功

无返回值

操作失败

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

示例代码

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

关闭专线通道的IPv6功能

函数声明

public void disableEtChannelIpv6(EtChannelIdRequest request) {
    ......
}

参数含义

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

返回值

操作成功

无返回值

操作失败

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

示例代码

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

新建专线通道路由规则

函数声明

public CreateEtChannelRouteResponse createEtChannelRouteRule(CreateEtChannelRouteRuleRequest request) {
    ......
}

参数含义

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

返回值

操作成功

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

操作失败

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

示例代码

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

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

函数声明

public ListEtChannelRouteRulesResponse listEtChannelRouteRules(ListEtChannelRouteRulesRequest request) {
    ......
}

参数含义

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

返回值

操作成功

{
    "metadata":具体信息参考附录metadata部分,
    "nextMarker": "14eabc99-dce7-11ec-84d4-6c92bf29c398",
    "maxKeys": 1,
    "isTruncated": true,
    "routeRules": [{
        "routeRuleId": "dcrr-5afcf643-94e",
        "ipVersion": 4,
        "destAddress": "10.0.0.1/32",
        "nexthopType": "etGateway"
        "nexthopId": "dcgw-arc647h3014w",
        "description": "route_1"
    }]
}

操作失败

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

示例代码

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

修改专线通道路由规则

函数声明

public void updateEtChannelRouteRule(UpdateEtChannelRouteRuleRequest request) {
    ......
}

参数含义

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

返回值

操作成功

无返回值

操作失败

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

示例代码

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

删除专线通道路由规则

函数声明

public void deleteEtRouteRule(EtChannelRouteRuleIdRequest request) {
    ......
}

参数含义

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

返回值

操作成功

无返回值

操作失败

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

示例代码

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

附录

公共返回信息metadata格式

 {
      "bceRequestId":"f5f0821d-45fe-439b-bbf4-fc48b639f84a",
      "contentLength":28,
      "contentType":"application/json;charset=UTF-8",
      "date":1701917695000,
      "server":"openresty/1.15.8.1"
 }

初始化

异常处理

百度智能云

专线 ET

专线 ET

专线

获取Endpoint

获取AK/SK

新建EtClient

申请物理专线

查询专线列表

查询网络探测详情

更新物理专线

新建专线通道

查询专线通道列表

重新提交专线通道

更新专线通道

删除专线通道

打开专线通道的IPv6功能

关闭专线通道的IPv6功能

新建专线通道路由规则

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

修改专线通道路由规则

删除专线通道路由规则

附录