更新时间：2025-12-16 GMT+08:00
创建对等连接 - CreateVpcPeering
功能介绍
创建对等连接。
同一租户下创建对等连接时，无需对端接受对等连接请求即可创建成功。
不同租户创建对等连接时，需要对端租户接受请求才可以创建成功。对端租户拒绝请求时，对等连接无法创建。
调试
您可以在API Explorer中调试该接口。
授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
- 如果使用身份策略授权，需具备如下身份策略权限。
授权项
访问级别
资源类型（*为必须）
条件键
别名
依赖的授权项
vpc:peerings:create
Write
peering *
- vpc:AccepterVpcId
- vpc:RequesterVpcId
- vpc:AccepterVpcOrgPath
- vpc:AccepterVpcOwner
-
-
vpc *
- g:ResourceTag/<tag-key>
- vpc:VpcId
URI
POST /v2.0/vpc/peerings
请求参数
请求示例
- 创建一个对等连接，请求方vpc id为9daeac7c-a98f-430f-8e38-67f9c044e299，接收方vpc id为f583c072-0bb8-4e19-afb2-afb7c1693be5，命名为test。
POST https://{Endpoint}/v2.0/vpc/peerings { "peering": { "name": "test", "description": "test", "request_vpc_info": { "vpc_id": "9daeac7c-a98f-430f-8e38-67f9c044e299" }, "accept_vpc_info": { "vpc_id": "f583c072-0bb8-4e19-afb2-afb7c1693be5" } } }
响应参数
|
参数名称 |
类型 |
说明 |
|---|---|---|
|
id |
String |
对等连接id |
|
name |
String |
对等连接的名称 |
|
status |
String |
状态：
|
|
request_vpc_info |
vpc_info object |
对等连接发起端vpc信息，请参见表6。 |
|
accept_vpc_info |
vpc_info object |
对等连接接受端vpc信息，请参见表6。 |
|
description |
String |
对等连接描述 |
|
created_at |
String |
资源创建时间，UTC时间 格式：yyyy-MM-ddTHH:mm:ss |
|
updated_at |
String |
资源更新时间，UTC时间 格式：yyyy-MM-ddTHH:mm:ss |
响应示例
{
"peering": {
"name": "test",
"id": "22b76469-08e3-4937-8c1d-7aad34892be1",
"request_vpc_info": {
"vpc_id": "9daeac7c-a98f-430f-8e38-67f9c044e299",
"tenant_id": "f65e9ebc-ed5d-418b-a931-9a723718ba4e"
},
"accept_vpc_info": {
"vpc_id": "f583c072-0bb8-4e19-afb2-afb7c1693be5",
"tenant_id": "f65e9ebc-ed5d-418b-a931-9a723718ba4e"
},
"status": "ACTIVE"
}
}
状态码
请参见状态码。
错误码
请参考错误码。
