创建跨地域对等连接

最近更新时间:2018-05-28 20:26:01

接口描述

用于创建跨地域对等连接的接口。
域名:vpc.api.qcloud.com
接口名:CreateVpcPeeringConnectionEx

  • 跨地域对等连接用于打通两个不同地域下的私有网络,需要互通的两个私有网络网段不能重叠。
  • 跨账户的对等连接需要对端接受才生效,同账户的立即生效。
  • 跨域互通带宽可以设置,创建后如果需要调整请联系客服申请。
  • 跨地域互通目前支持的地域、支持的带宽上限、收费标准请参见 对等连接介绍

请求参数

以下请求参数列表仅列出了接口请求参数,正式调用时需要加上公共请求参数,详情请参见 公共请求参数 页面。其中,此接口的 Action 字段为 CreateVpcPeeringConnectionEx

参数 必选 类型 描述
vpcId String 私有网络 ID 值,可使用 vpcId 或 unVpcId,建议使用 unVpcId
可通过 DescribeVpcEx 接口 查询
peerVpcId String 接受方私有网络 ID 值,可使用 vpcId 或 unVpcId,建议使用 unVpcId
可通过 DescribeVpcEx 接口

查询 |
| peerUin | 是 | String | 接收方腾讯云唯一账号标识,您可以联系接收方去用户中心的个人信息中查看,详情请参见 操作指南 |
| peeringConnectionName | 是 | String | 对等连接名称,可任意命名,但不得超过 60 个字符 |
| peerRegion | 是 | String | 接收方地域,目前支持的地域请参见 地域介绍 |
| bandwidth | 是 | String | 对等连接带宽上限,单位:Mbps,默认不限制
具体数值请参见 对等连接产品介绍 |
| type | 否 | Int | 互通类型,默认值1
1:VPC 间互通
2:VPC 与黑石网络互通|

响应参数

参数 类型 描述
code Int 错误码
0:成功
其他值:失败
message String 错误信息
taskId Int 任务 ID,创建结果可以用 taskId 查询
详情请参见 查询任务执行结果接口

错误码

以下错误码表仅列出了该接口的业务逻辑错误码,更多公共错误码请参见 VPC 错误码

错误码 描述
InvalidPeeringConnectionName 对等连接名称不合法
可任意命名,但不得超过 60 个字符
PeeringConnectionVpcConflict 对等连接之间 VPC 网段冲突
PeeringConnectionLimitExceeded 您已经达到指定区域对等连接资源申请数量上限。如果需要更多资源,请联系客服申请
更多 VPC 资源限制信息请参见 VPC 使用限制
InvalidVpc.NotFound 无效的 VPC,VPC 资源不存在
请再次核实您输入的资源信息是否正确

代码示例

请求示例

https://vpc.api.qcloud.com/v2/index.php?Action=CreateVpcPeeringConnectionEx
&<公共请求参数>
&vpcId=gz_vpc_226
&peerVpcId=gz_vpc_89
&peerUin=2407912486
&peeringConnectionName=tses
&peerRegion=gz
&bandwidth=20

响应示例

{
    "code":"0",
    "message":"",
    "taskId":112245
}