管理与支持产品文档捉虫活动邀您参加！> HOT
文档中心>API 中心>私有网络>私有网络 API 2017>对等连接相关接口>创建跨地域对等连接

创建跨地域对等连接

最近更新时间：2020-02-26 10:40:38

我的收藏

本页目录：

接口描述

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

请求参数

以下请求参数列表仅列出了接口请求参数，正式调用时需要加上公共请求参数，详情请参见 公共请求参数 页面。其中，此接口的 Action 字段为 CreateVpcPeeringConnectionEx。
参数
必选
类型
描述
vpcId
是
String
私有网络 ID 值，可使用 vpcId 或 unVpcId，建议使用 unVpcId
可通过 DescribeVpcEx 接口 查询
peerVpcId
是
String
接受方私有网络 ID 值，可使用 vpcId 或 unVpcId，建议使用 unVpcId
可通过 DescribeVpcEx 接口 查询
peerUin
是
String
接收方腾讯云唯一账号标识，您可以联系接收方去用户中心的个人信息中查看，详情请参见 查看对端账号 ID
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
您已经达到指定区域对等连接资源申请数量上限。如果需要更多资源，请联系客服申请</br>
更多 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
}

中国站
目录