Create dedicated channel
Updated at：2025-11-11
Description
Create a new dedicated channel. Channels can only be created when the dedicated line is in an "Available" status.
Request structure
Plain Text
1POST /v{version}/et/{etId}/channel?clientToken={clientToken} HTTP/1.1
2Host: bcc.bj.baidubce.com
3Authorization: authorization string
4 {
5 "authorizedUsers": {authorizedUsers},
6 "description": {description},
7 "baiduAddress": {baiduAddress},
8 "name": {name},
9 "networks": {networks},
10 "customerAddress": {customerAddress},
11 "routeType": {routeType},
12 "vlanId": {vlanId},
13 "enableIpv6": {enableIpv6},
14 "baiduIpv6Address": {baiduIpv6Address},
15 "customerIpv6Address": {customerIpv6Address},
16 "ipv6Networks": {ipv6Networks},
17 "tags": {tags}
18 }Request headers
There are no special headers required beyond the common headers.
Request parameters
| Parameter name | Types | Whether required | Parameter location | Description |
|---|---|---|---|---|
| version | String | Yes | URL parameter | For API version No., the current value is 1 |
| clientToken | String | No | Query | Idempotence Token, which is an ASCII string with a length not exceeding 64 bits, see details in [ClientToken Idempotence Support](ET/API Reference/General Description.md#Idempotence). |
| etId | String | Yes | URL parameter | Dedicated line ID |
| authorizedUsers | List<String> | No | RequestBody | Allocation object |
| description | String | No | RequestBody | Description |
| baiduAddress | String | Yes | RequestBody | Cloud network interconnection IP |
| name | String | Yes | RequestBody | Channel name |
| networks | List<String> | No | RequestBody | Routing parameters, required only when "routeType" is "static-route" |
| customerAddress | String | Yes | RequestBody | IDC interconnection IP |
| routeType | String | Yes | RequestBody | Route protocol, currently supporting "static-route" (static) and "bgp" (dynamic) |
| vlanId | Integer | Yes | RequestBody | VLAN ID, with value range being 0, 2-4009 |
| bgpAsn | String | No | RequestBody | BGP ASN, with valid range being 1-4294967295, Baidu AI Cloud ASN: 45085; required only when "routeType" is "bgp" |
| bgpKey | String | No | RequestBody | BGP key, required only when "routeType" is "bgp" |
| enableIpv6 | Integer | No | RequestBody | Whether the IPv6 function is enabled: 1 for yes and 0 for no. IPv6 features an allow list function |
| baiduIpv6Address | String | No | RequestBody | Cloud-side IPv6 interconnection address, required when enableIpv6=1 |
| customerIpv6Address | String | No | RequestBody | IDC-side IPv6 interconnection address, required when enableIpv6=1 |
| ipv6Networks | List<String> | No | RequestBody | IPv6 routing parameters, required when enableIpv6=1 and “routeType” is “static-route” |
| tags | List<[TagModel](ET/API Reference/Appendix.md#TagModel)> | No | RequestBody | List of tag key-value pairs to be created |
Response headers
No special headers are required beyond the standard ones.
Response parameters
| Parameter name | Types | Description |
|---|---|---|
| id | String | Dedicated channel ID |
Request example
Plain Text
1POST /v1/et/dcphy-gq65bz9ip712/channel?clientToken=1849ef6b-f73c-4f5d-b88b-259ca47af849 HTTP/1.1
2Host: bcc.bj.baidubce.com
3Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
4{
5 "authorizedUsers": [
6 "8770d0e94e2728ca81b0ec99db9f4df8"
7 ],
8 "description": "",
9 "baiduAddress": "11.11.11.21/24",
10 "name": "channel_name",
11 "networks": [
12 "192.168.0.0/16"
13 ],
14 "customerAddress": "11.11.11.12/24",
15 "routeType": "static-route",
16 "vlanId": 56,
17 "enableIpv6": 1,
18 "baiduIpv6Address": "2400:da00:e003:0:1eb:200::1/88",
19 "ipv6Networks": [
20 "2400:da00:e003:0:15f::/87"
21 ],
22 "customerIpv6Address": "2400:da00:e003:0:0:200::1/88",
23 "tags":[
24 {
25 "tagKey": "tagKey",
26 "tagValue": "tagValue"
27 }
28 ]
29}Response example
Plain Text
1HTTP/1.1 200 OK
2x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
3Date: Thu, 16 Mar 2017 06:29:48 GMT
4Content-Type: application/json;charset=UTF-8
5Server: BWS
6 {
7 "id": "vpnconn-ku4cxya6nisq"
8 }