租户端 网络 私有网络（VPC） 历史版本（V2接口）

创建跨地域对等连接

最近更新时间: 2024-10-17 17:10:00

接口描述

用于创建跨地域对等连接的接口。 域名：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 查询
详情请参见 查询任务执行结果接口

错误码

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

错误码 描述
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
}