首页/云/云网络与负载均衡速查/对等连接 CLI 操作示例(腾讯云)

对等连接 CLI 操作示例(腾讯云)

腾讯云对等连接可用 tccli 创建与接受:发起端 CreateVpcPeeringConnection 指定对端账号与 VPC,对端账号接受后,两端分别在路由表中为对端网段添加一条指向对等连接的路由。

对等连接 CLI 是什么

对等连接(VPC Peering)把两个 VPC 私网打通,流量走内网、不经过公网。腾讯云可以用 tccli 完成整套动作:发起端创建对等连接并指定对端账号与 VPC,对端账号接受连接,然后两端分别在各自路由表里加一条指向对等连接的路由。同账号同地域最简单,跨账号或跨地域要额外补角色授权与地域参数。

基本信息

工具tccli(腾讯云 CLI,需先配置 SecretId/SecretKey)
关键对象对等连接实例 ID(pcx-xxxxxxxx)
跨账号参数PeerUin(对端账号 UIN)、对端 VPC ID
跨地域参数PeerRegion 必填且与对端地域一致
必要动作双方各加一条目的网段指向对等连接的路由
权限发起端与接受端账号各自的访问密钥

典型使用场景

  • 同一账号下测试环境与共享服务 VPC 互通,避免走公网
  • 跨账号业务对接:A 公司的 VPC 与 B 公司的 VPC 点对点打通
  • 把新建的业务 VPC 接入现有基础服务 VPC(数据库、日志、镜像仓库)
  • 批量运维:用脚本一次性创建多条对等连接,减少控制台重复操作
  • 临时联调:项目结束后删除对等连接即可回收路径

创建、接受与添加路由

创建、接受与添加路由
# 1 发起端(账号 A)创建对等连接
tccli vpc CreateVpcPeeringConnection \
  --VpcId vpc-aaaa --PeerVpcId vpc-bbbb --PeerUin 10000xxxxx \
  --PeeringConnectionName to-accountB
# 2 接受端(账号 B)接受
# tccli vpc AcceptVpcPeeringConnection --PeeringConnectionId pcx-xxxxxxxx
# 3 两端各自加路由:目的网段 = 对端 VPC 网段,下一跳 = 对等连接
# 4 验证
tccli vpc DescribeVpcPeeringConnections --PeeringConnectionIds pcx-xxxxxxxx

配置项对照

字段含义填错的表现
VpcId发起端 VPC 实例 ID创建在对端也建不上,直接报错
PeerVpcId对端 VPC 实例 ID跨账号时对端账号找不到该连接
PeerUin对端账号 UIN跨账号创建失败或对端无法接受
PeerRegion对端地域,跨地域必填报参数缺失,或建到错误地域
下一跳必须是对等连接 ID误填 VPC ID 时路由存在但不生效
创建与接受要在两个账号下分别执行,把每一步的参数、返回的实例 ID 和执行时间记录留存;出问题时能直接判断卡在创建、接受还是路由哪一环。
对等连接只打通网络路径,不改变安全策略:两侧安全组与网络 ACL 仍需放行对端网段,否则表现为「路由有、ping 不通」。

易错点

  • 跨地域时必须填 PeerRegion 且与对端地域一致,漏填或填错会创建失败
  • 路由的下一跳要选对等连接实例 ID,误填 VPC ID 会导致路由已存在但流量不走对等连接
  • 只在一端加路由,形成单向可达,排障时容易被误判为对端主机故障
  • 网段重叠的 VPC 无法通过对等连接打通,只能重新规划网段或改走 NAT
  • 忘记处理对端账号的角色授权,接受操作会因权限不足失败

数据来源与参考

  • 腾讯云 API 文档(CreateVpcPeeringConnection / AcceptVpcPeeringConnection)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌