# 更新对等连接 - UpdateVpcPeering
#### 功能介绍
更新对等连接。
#### 调试
您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=VPC&version=v2&api=UpdateVpcPeering)中调试该接口。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-vpc/vpc_permission_0000.html)。
- 如果使用身份策略授权，需具备如下身份策略权限。
  
  | 授权项                 | 访问级别  | 资源类型（\*为必须） | 条件键                                                                                                                                                                                                                                                                                                            | 别名 | 依赖的授权项 |
  |:---|:---|:---|:---|:---|:---|
  | vpc:peerings:update | Write | peering \*  | - vpc:AccepterVpcId  - vpc:RequesterVpcId  - vpc:PeeringId   | -  | -      |
     
  
 
#### URI
PUT /v2.0/vpc/peerings/{peering_id}
参数说明请参见[表1]。
 表1参数说明 
| 名称         | 是否必选 | 参数类型   | 说明        |
|:---|:---|:---|:---|
| peering_id | 是    | String | 对等连接的唯一标识 |
   
#### 请求参数
表2请求参数 
| 参数名称    | 是否必选 | 类型                                                      | 说明                                                                                                                                        |
|:---|:---|:---|:---|
| peering | 是    | [peering] object | peering对象中要更新的字段，请参见[表3]。 更新操作时至少指定一项属性，目前只支持更新name和description。 |
   
 表3对等连接更新字段说明 
| 参数名称        | 是否必选 | 类型     | 说明                                |
|:---|:---|:---|:---|
| name        | 否    | String | 对等连接名称，支持长度为1-64字符                |
| description | 否    | String | 对等连接描述，取值范围：0-255个字符，支持数字、字母、中文字符 |
   
#### 请求示例
- 更新id为7a9a954a-eb41-4954-a300-11ab17a361a2的对等连接，名称更新为test2。
  ```
  PUT https://{Endpoint}/v2.0/vpc/peerings/7a9a954a-eb41-4954-a300-11ab17a361a2 
  { 
      "peering": { 
          "name": "test2" 
      } 
  }
  ```
  
 
#### 响应参数
表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": "test2", 
        "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": "059a737356594b41b447b557bf0aae56"
        }, 
        "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)。