文档首页/虚拟私有云 VPC/API参考/API V1/V2/对等连接/更新对等连接 - UpdateVpcPeering
更新时间：2025-12-23 GMT+08:00
查看PDF
分享

更新对等连接 - UpdateVpcPeering

功能介绍

更新对等连接。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
  • 如果使用身份策略授权，需具备如下身份策略权限。

    授权项

    访问级别

    资源类型（*为必须）

    条件键

    别名

    依赖的授权项

    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。

表5 peering对象

参数名称

类型

说明

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

表6 vpc_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"
    }
}

状态码

请参见状态码。

错误码

请参考错误码。

父主题： 对等连接