新建专线通道
更新时间：2024-12-27
描述
新建专线通道，仅当专线状态为“可用”时通道才能创建。
请求结构
POST /v{version}/et/{etId}/channel?clientToken={clientToken} HTTP/1.1
Host: bcc.bj.baidubce.com
Authorization: authorization string
{
"authorizedUsers": {authorizedUsers},
"description": {description},
"baiduAddress": {baiduAddress},
"name": {name},
"networks": {networks},
"customerAddress": {customerAddress},
"routeType": {routeType},
"vlanId": {vlanId},
"enableIpv6": {enableIpv6},
"baiduIpv6Address": {baiduIpv6Address},
"customerIpv6Address": {customerIpv6Address},
"ipv6Networks": {ipv6Networks},
"tags": {tags}
} 请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号，当前取值为1 |
| clientToken | String | 否 | Query参数 | 幂等性Token，是一个长度不超过64位的ASCII字符串，详见ClientToken幂等性支持。 |
| etId | String | 是 | URL参数 | 专线的ID |
| authorizedUsers | List<String> | 否 | RequestBody参数 | 分配对象 |
| description | String | 否 | RequestBody参数 | 描述 |
| baiduAddress | String | 是 | RequestBody参数 | 云端网络互联IP |
| name | String | 是 | RequestBody参数 | 通道名称 |
| networks | List<String> | 否 | RequestBody参数 | 路由参数，仅当“routeType”为“static-route”时需要 |
| customerAddress | String | 是 | RequestBody参数 | IDC互联IP |
| routeType | String | 是 | RequestBody参数 | 路由协议，当前支持”static-route“（静态）和”bgp“（动态） |
| vlanId | Integer | 是 | RequestBody参数 | VLAN ID，取值范围：0, 2-4009 |
| bgpAsn | String | 否 | RequestBody参数 | BGP ASN，有效范围：1-4294967295，百度智能云ASN:45085；仅当“routeType”为“bgp”时需要 |
| bgpKey | String | 否 | RequestBody参数 | BGP 密钥，仅当“routeType”为“bgp”时需要 |
| enableIpv6 | Integer | 否 | RequestBody参数 | IPv6功能是否开启，1是0否，IPv6为白名单功能 |
| baiduIpv6Address | String | 否 | RequestBody参数 | 云端网络侧IPv6互联地址，enableIpv6=1时需要 |
| customerIpv6Address | String | 否 | RequestBody参数 | IDC侧IPv6互联地址，enableIpv6=1时需要 |
| ipv6Networks | List<String> | 否 | RequestBody参数 | IPv6路由参数，当enableIpv6=1且“routeType”为“static-route”时需要 |
| tags | List<TagModel> | 否 | RequestBody参数 | 待创建的标签键值对列表 |
返回头域
除公共头域，无其它特殊头域。
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| id | String | 专线通道的ID |
请求示例
POST /v1/et/dcphy-gq65bz9ip712/channel?clientToken=1849ef6b-f73c-4f5d-b88b-259ca47af849 HTTP/1.1
Host: bcc.bj.baidubce.com
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
{
"authorizedUsers": [
"8770d0e94e2728ca81b0ec99db9f4df8"
],
"description": "",
"baiduAddress": "11.11.11.21/24",
"name": "channel_name",
"networks": [
"192.168.0.0/16"
],
"customerAddress": "11.11.11.12/24",
"routeType": "static-route",
"vlanId": 56,
"enableIpv6": 1,
"baiduIpv6Address": "2400:da00:e003:0:1eb:200::1/88",
"ipv6Networks": [
"2400:da00:e003:0:15f::/87"
],
"customerIpv6Address": "2400:da00:e003:0:0:200::1/88",
"tags":[
{
"tagKey": "tagKey",
"tagValue": "tagValue"
}
]
}返回示例
HTTP/1.1 200 OK
x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
Date: Thu, 16 Mar 2017 06:29:48 GMT
Content-Type: application/json;charset=UTF-8
Server: BWS
{
"id": "vpnconn-ku4cxya6nisq"
}