# 创建对等连接 - CreateVpcPeering #### 功能介绍 创建对等连接。 同一租户下创建对等连接时，无需对端接受对等连接请求即可创建成功。 不同租户创建对等连接时，需要对端租户接受请求才可以创建成功。对端租户拒绝请求时，对等连接无法创建。 #### 调试 您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=VPC&version=v2&api=CreateVpcPeering)中调试该接口。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-vpc/vpc_permission_0000.html)。 - 如果使用身份策略授权，需具备如下身份策略权限。 | 授权项 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 | |:---|:---|:---|:---|:---|:---| | vpc:peerings:create | Write | peering \* | - vpc:AccepterVpcId - vpc:RequesterVpcId - vpc:AccepterVpcOrgPath - vpc:AccepterVpcOwner | - | - | | vpc:peerings:create | Write | vpc \* | - [g:ResourceTag/\](https://support.huaweicloud.com/usermanual-iam5/iam_01_1287.html) - vpc:VpcId | - | - | #### URI POST /v2.0/vpc/peerings #### 请求参数 表1请求参数 | 参数名称 | 是否必选 | 类型 | 说明 | |:---|:---|:---|:---| | peering | 是 | [peering] object | peering对象，参见[表2]。 | 表2peering对象创建字段说明 | 参数名称 | 是否必选 | 类型 | 说明 | |:---|:---|:---|:---| | name | 是 | String | 对等连接的名称，支持长度为1-64。 | | description | 否 | String | 对等连接的描述。 取值范围：0-255个字符，不能包含"\<"和"\>"。 | | request_vpc_info | 是 | [vpc_info] object | 对等连接发起端vpc信息，请参见[表3]。 | | accept_vpc_info | 是 | [vpc_info] object | 对等连接接受端vpc信息，请参见[表3]。 | 表3vpc_info对象字段说明 | 参数名称 | 是否必选 | 类型 | 说明 | |:---|:---|:---|:---| | vpc_id | 是 | String | 对等连接其中一端vpc id | | tenant_id | 否 | String | 对等连接其中一端vpc所属的项目id 约束：跨租户创建时必须指定该字段。 | #### 请求示例 - 创建一个对等连接，请求方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" } } } ``` #### 响应参数 表4响应参数 | 参数名称 | 类型 | 说明 | |:---|:---|:---| | peering | [peering] object | peering对象，请参见[表5]。 | 表5peering对象 | 参数名称 | 类型 | 说明 | |:---|:---|:---| | id | String | 对等连接id | | name | String | 对等连接的名称 | | status | String | 状态： - PENDING_ACCEPTANCE：等待接受 - REJECTED：已拒绝。 - EXPIRED：已过期。 - DELETED：已删除。 - ACTIVE：活动的。 | | 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 | 表6vpc_info对象 | 参数名称 | 类型 | 说明 | |:---|:---|:---| | vpc_id | String | 对等连接其中一端vpc id | | tenant_id | String | 对等连接其中一端vpc所属的项目id | #### 响应示例 ``` { "peering": { "name": "test", "description": "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", "created_at": "2026-04-15T07:43:34", "updated_at": "2026-04-15T07:43:36" } } ``` #### 状态码 请参见[状态码](https://support.huaweicloud.com/api-vpc/vpc_api_0002.html)。 #### 错误码 请参考[错误码](https://support.huaweicloud.com/api-vpc/vpc_api_0003.html)。