创建对等连接
更新时间：2024-08-08
描述
创建对等连接
- 对于本端区域和对端区域相同的对等连接，只支持后付费。
- 跨账号的对等连接，必须接受端接受后对等连接才可用。
- 对于同账号的对等连接，系统会触发对端自动接受。
- 任意两个VPC之间最多只能存在一条对等连接。
- 发起端和接收端的VPC不能是同一个。
- 如果本端vpc和对端vpc均为中继vpc,则不可以建立对等连接。
请求结构
POST /v{version}/peerconn?clientToken={clientToken} HTTP/1.1
Host: bcc.bj.baidubce.com
Authorization: authorization string
{
"bandwidthInMbps" : bandwidthInMbps,
"description" : description,
"localIfName" : localIfName,
"localVpcId" : localVpcId,
"peerAccountId": peerAccountId,
"peerVpcId" : peerVpcId,
"peerRegion" : peerRegion,
"peerIfName" : peerIfName,
"billing": {
"paymentTiming": paymentTiming,
"reservation": {
"reservationLength": reservationLength,
"reservationTimeUnit": reservationTimeUnit
}
},
"tags":[
{
"tagKey": tagKey,
"tagValue": tagValue
}
],
"resourceGroupId": resourceGroupId,
"deleteProtect": deleteProtect
}请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号，当前取值1 |
| clientToken | String | 是 | Query参数 | 幂等性Token，是一个长度不超过64位的ASCII字符串，详见ClientToken幂等性 |
| bandwidthInMbps | int | 是 | 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参数 | 资源组 |
| deleteProtect | Boolean | 否 | RequestBody参数 | 是否开启释放保护。缺省值为false，代表允许删除 |
返回头域
除公共头域，无其它特殊头域。
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| peerConnId | String | 创建的对等连接ID |
请求示例-本账号
POST /v1/peerconn?clientToken=be31b98c-5e51-48e8-9830-9be700de5a20 HTTP/1.1
Host: bcc.bj.baidubce.com
Authorization: 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
ContentType: application/json
{
"bandwidthInMbps":500,
"description":"peer_same_account",
"localIfName":"localIfName",
"localVpcId":"vpc-13vuxu016dew",
"peerVpcId":"vpc-jcvmhw9h1a35",
"peerRegion":"bj",
"peerIfName":"peerIfName",
"billing":{
"paymentTiming":"Postpaid"
},
"tags":[
{
"tagKey": "tagKey",
"tagValue": "tagValue"
}
],
"resourceGroupId": "RESG-UoMgbkuLNjj"
}
请求示例-跨账号
POST /v1/peerconn?clientToken=be31b98c-5ss1-4638-9530-9be700de5a20 HTTP/1.1
Host: bcc.bj.baidubce.com
content-type: application/json
authorization: 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
{
"bandwidthInMbps":500,
"description":"peer_diff_account",
"localIfName":"sss",
"localVpcId":"vpc-zuqfiksbu5cu",
"peerAccountId":"7058ff6052254a679f5714548feda935",
"peerVpcId":"vpc-mivwn2w9xicb",
"peerRegion":"bj",
"billing":{
"paymentTiming":"Postpaid"
},
"tags":[
{
"tagKey": "tagKey",
"tagValue": "tagValue"
}
],
"resourceGroupId": "RESG-UoMgbkuLNjj",
"deleteProtect":true
}返回示例
HTTP/1.1 200 OK
x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
Date: Fri, 06 July 2018 07:06:06 GMT
Content-Type: application/json;charset=UTF-8
Server: BWS
{
"peerConnId": "peerconn-9td54fmx143e"
}