新建专线通道
更新时间:2024-05-24
描述
新建专线通道,仅当专线状态为“可用”时通道才能创建
请求结构
POST /v{version}/et/{etId}/channel?clientToken={clientToken} HTTP/1.1
Host: bcc.bj.baidubce.com
Authorization: authorization string
{
"authorizedUsers": [],
"description": description,
"baiduAddress": baiduAddress,
"name": name,
"networks": [],
"customerAddress": customerAddress,
"routeType": routeType,
"vlanId": vlanId,
"enableIpv6": 1,
"baiduIpv6Address": baiduIpv6Address,
"customerIpv6Address": customerIpv6Address,
"ipv6Networks": [],
"tags": []
}
请求头域
除公共头域外,无其它特殊头域。
请求参数
参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
---|---|---|---|---|
version | String | 是 | URL参数 | API版本号 |
clientToken | String | 否 | Query参数 | 幂等性Token,是一个长度不超过64位的ASCII字符串,详见ClientToken幂等性。 |
etId | String | 是 | URL参数 | 专线的id |
authorizedUsers | List<String> | 否 | Request Body参数 | 分配对象 |
description | String | 否 | Request Body参数 | 描述 |
baiduAddress | String | 是 | Request Body参数 | 云端网络互联IP |
name | String | 是 | Request Body参数 | 通道名称 |
networks | List<String> | 否 | Request Body参数 | 路由参数,仅当“routeType”为“static-route”时需要 |
customerAddress | String | 是 | Request Body参数 | IDC互联IP |
routeType | String | 是 | Request Body参数 | 路由协议,当前支持”static-route“(静态)和”bgp“(动态) |
vlanId | Integer | 是 | Request Body参数 | VLAN ID,取值范围:0, 2-4009 |
bgpAsn | String | 否 | Request Body参数 | BGP ASN,有效范围:1-4294967295,百度智能云ASN:45085;仅当“routeType”为“bgp”时需要 |
bgpKey | String | 否 | Request Body参数 | BGP 密钥,仅当“routeType”为“bgp”时需要 |
enableIpv6 | Integer | 否 | Request Body参数 | IPv6功能是否开启,1是0否,IPv6为白名单功能 |
baiduIpv6Address | String | 否 | Request Body参数 | 云端网络侧IPv6互联地址,enableIpv6=1时需要 |
customerIpv6Address | String | 否 | Request Body参数 | IDC侧IPv6互联地址,enableIpv6=1时需要 |
ipv6Networks | List<String> | 否 | Request Body参数 | 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"
}