创建对等连接
更新时间：2024-12-30
描述
创建对等连接。
- 对于本端区域和对端区域相同的对等连接，只支持后付费；
- 跨账号的对等连接，必须接受端接受后对等连接才可用；
- 对于同账号的对等连接，系统会触发对端自动接受；
- 任意两个VPC之间最多只能存在一条对等连接；
- 发起端和接收端的VPC不能是同一个；
- 如果本端VPC和对端VPC均为中继VPC，则不可以建立对等连接；
请求结构
Plain Text
1POST /v{version}/peerconn?clientToken={clientToken} HTTP/1.1
2Host: bcc.bj.baidubce.com
3Authorization: authorization string
4{
5 "bandwidthInMbps" : bandwidthInMbps,
6 "description" : description,
7 "localIfName" : localIfName,
8 "localVpcId" : localVpcId,
9 "peerAccountId": peerAccountId,
10 "peerVpcId" : peerVpcId,
11 "peerRegion" : peerRegion,
12 "peerIfName" : peerIfName,
13 "billing": {
14 "paymentTiming": paymentTiming,
15 "reservation": {
16 "reservationLength": reservationLength,
17 "reservationTimeUnit": reservationTimeUnit
18 }
19 },
20 "tags":[
21 {
22 "tagKey": tagKey,
23 "tagValue": tagValue
24 }
25 ],
26 "resourceGroupId": resourceGroupId,
27 "deleteProtect": deleteProtect
28}请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号，当前取值1 |
| clientToken | String | 是 | Query参数 | 幂等性Token，是一个长度不超过64位的ASCII字符串，详见ClientToken幂等性 |
| bandwidthInMbps | Integer | 是 | RequestBody参数 | 对等连接的带宽 |
| description | String | 否 | RequestBody参数 | 对等连接的备注 |
| localIfName | String | 否 | RequestBody参数 | 本端接口名称 |
| localVpcId | String | 是 | RequestBody参数 | 本端VPC的ID |
| peerAccountId | String | 否 | RequestBody参数 | 对端账户ID，只有在建立跨账号的对等连接时需要该字段 |
| peerVpcId | String | 是 | RequestBody参数 | 对等连接对端VPC的ID |
| peerRegion | String | 是 | RequestBody参数 | 对等连接的对端区域 |
| peerIfName | String | 否 | RequestBody参数 | 对等连接对端接口名称，只有本账号的对等连接才允许设置该字段 |
| billing | Billing | 是 | RequestBody参数 | 计费信息 |
| tags | List<TagModel> | 否 | RequestBody参数 | 待创建的标签键值对列表 |
| resourceGroupId | String | 否 | RequestBody参数 | 资源组ID |
| deleteProtect | Boolean | 否 | RequestBody参数 | 是否开启释放保护。缺省值为false，代表允许删除 |
返回头域
除公共头域，无其它特殊头域。
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| peerConnId | String | 创建的对等连接ID |
请求示例-本账号
Plain Text
1POST /v1/peerconn?clientToken=be31b98c-5e51-48e8-9830-9be700de5a20 HTTP/1.1
2Host: bcc.bj.baidubce.com
3Authorization: bce-auth-v1/930192808c0c11e8b62ccf3a4a052967/2018-07-20T11:06:43Z/3600/host;x-bce-account;x-bce-client-ip;x-bce-date;x-bce-request-id;x-bce-security-token/749f35181233d0f744f30e77457dc605c6eed31c9a45856e2bf8c415245d9af1
4{
5 "bandwidthInMbps":500,
6 "description":"peer_same_account",
7 "localIfName":"localIfName",
8 "localVpcId":"vpc-13vuxu016dew",
9 "peerVpcId":"vpc-jcvmhw9h1a35",
10 "peerRegion":"bj",
11 "peerIfName":"peerIfName",
12 "billing":{
13 "paymentTiming":"Postpaid"
14 },
15 "tags":[
16 {
17 "tagKey": "tagKey",
18 "tagValue": "tagValue"
19 }
20 ],
21 "resourceGroupId": "RESG-UoMgbkuLNjj"
22}
23 请求示例-跨账号
Plain Text
1POST /v1/peerconn?clientToken=be31b98c-5ss1-4638-9530-9be700de5a20 HTTP/1.1
2Host: bcc.bj.baidubce.com
3Authorization: bce-auth-v1/930192808c0c11e8b62ccf3a4a052967/2018-07-20T11:06:43Z/3600/host;x-bce-account;x-bce-client-ip;x-bce-date;x-bce-request-id;x-bce-security-token/749f35181233d0f744f30e77457dc605c6eed31c9a45856e2bf8c415245d9af1
4{
5 "bandwidthInMbps":500,
6 "description":"peer_diff_account",
7 "localIfName":"sss",
8 "localVpcId":"vpc-zuqfiksbu5cu",
9 "peerAccountId":"7058ff6052254a679f5714548feda935",
10 "peerVpcId":"vpc-mivwn2w9xicb",
11 "peerRegion":"bj",
12 "billing":{
13 "paymentTiming":"Postpaid"
14 },
15 "tags":[
16 {
17 "tagKey": "tagKey",
18 "tagValue": "tagValue"
19 }
20 ],
21 "resourceGroupId": "RESG-UoMgbkuLNjj",
22 "deleteProtect":true
23}返回示例
Plain Text
1HTTP/1.1 200 OK
2x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
3Date: Fri, 06 July 2018 07:06:06 GMT
4Content-Type: application/json;charset=UTF-8
5Server: BWS
6
7{
8 "peerConnId": "peerconn-9td54fmx143e"
9}