全部产品
Search
文档中心

专有网络 VPC:AssociatePhysicalConnectionToVirtualBorderRouter - 将VBR关联物理专线

更新时间:Mar 04, 2024

调用AssociatePhysicalConnectionToVirtualBorderRouter接口将边界路由器VBR(Virtual Border Router)关联到物理专线。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
vpc:AssociatePhysicalConnectionToVirtualBorderRouterWrite
  • PhysicalConnection
    acs:vpc:{#regionId}:{#accountId}:physicalconnection/{#PhysicalConnectionId}
  • VirtualBorderRouter
    acs:vpc:{#regionId}:{#accountId}:virtualborderrouter/{#VirtualBorderRouterId}

请求参数

名称类型必填描述示例值
RegionIdstring

物理专线所在的地域 ID。

您可以通过调用 DescribeRegions 接口获取地域 ID。

cn-hangzhou
VbrIdstring

VBR 实例 ID。

vbr-bp186tnz6rijyhj******
PhysicalConnectionIdstring

物理专线实例 ID。

pc-bp1qrb3044eqixog****
VlanIdstring

VBR 的 VLAN ID,取值范围:0~2999

说明 只有物理专线的所有者可以指定该参数,同一条物理专线下的两个 VBR 的 VLAN ID 不能相同。
123
CircuitCodestring

运营商为物理专线提供的电路编码。

说明 只有物理专线的所有者可以指定该参数。
longtel001
LocalGatewayIpstring

VBR 实例的阿里云侧互联 IP。

192.168.XX.XX
PeerGatewayIpstring

VBR 实例的客户侧互联 IP。

  • 该属性只允许 VBR 所有者指定或修改。

  • 为物理专线所有者创建 VBR 实例时必填。

192.168.XX.XX
PeeringSubnetMaskstring

VBR 实例的阿里云侧和客户侧互联 IP 的子网掩码。

两个 IP 地址必须位于同一个子网中。

255.255.255.0
ClientTokenstring

客户端 Token,用于保证请求的幂等性。

由客户端生成该参数值,要保证在不同请求间唯一,最大值不超过 64 个 ASCII 字符。

说明 若您未指定,则系统自动使用 API 请求的 RequestId 作为 ClientToken 标识。每次 API 请求的 RequestId 可能不一样。
123e4567-e89b-12d3-a456-426655440000
LocalIpv6GatewayIpstring

VBR 实例的阿里云侧互联 IPv6 地址。

2001:XXXX:3c4d:0015:0000:0000:0000:1a2b
PeerIpv6GatewayIpstring

VBR 实例的客户侧互联 IPv6 地址。

  • 该属性只允许 VBR 所有者指定或者修改。

  • 为物理专线所有者创建 VBR 实例时必填。

2001:XXXX:4:4:4:4:4:4
PeeringIpv6SubnetMaskstring

VBR 实例的阿里云侧和客户侧互联 IPv6 的子网掩码。

两个 IPv6 地址必须位于同一个子网中。

2408:4004:cc:400::/56
EnableIpv6string

是否启用 IPv6。取值:

  • true:开启。

  • false(默认值):关闭。

false

返回参数

名称类型描述示例值
object
RequestIdstring

请求 ID。

980960B0-2969-40BF-8542-EBB34FD358AB

示例

正常返回示例

JSON格式

{
  "RequestId": "980960B0-2969-40BF-8542-EBB34FD358AB"
}

错误码

HTTP status code错误码错误信息描述
400InvalidOperation.RouterInterfaceNotDeletedThe specified VirutalBorderRouter still has routerInterface.该边界路由器还有关联的路由器接口。
400InvalidOperation.OperationNotAllowedInStateThe specified VirutalBorderRouter is in invalid state.该VirutalBorderRouter状态不合法,请检查VirutalBorderRouter状态。
400InvalidStatus.NotAllowedInvalid virtual border router status.当前边界路由器的状态不支持该操作。
400InvalidPhysicalConnectionId.NotFoundThe specified PhysicalConnectionId is not found.该物理专线ID不存在。
400InvalidVlanId.UsedThe specified VlanId has been used.该VLAN已经被占用。
400MissingParameterThe input parameter 'PhysicalConnectionId' that is mandatory for processing this request is not supplied.必须指定参数PhysicalConnectionId。
400InvalidPhysicalConnectionId.NotEnabledThe specified PhysicalConnectionId is not in Enabled state.该物理专线当前未处于正常状态,请检查物理专线后再创建。
400MissingParameterThe input parameter 'VlanId' that is mandatory for processing this request is not supplied.必须指定参数VlanId。
400InvalidVlanId.MalformedThe specified VlanId is not valid.参数VlanId的值不合法。
400InvalidCircuitCode.MalformedThe specified CircuitCode is not valid.该CircuitCode不合法。
400MissingParameterThe input parameter 'LocalGatewayIp' that is mandatory for processing this request is not supplied.必须指定参数LocalGatewayIp。
400InvalidLocalGatewayIp.MalformedThe specified LocalGatewayIp is not valid.该本端网关的IP不合法。
400MissingParameterThe input parameter 'PeerGatewayIp' that is mandatory for processing this request is not supplied.必须指定参数PeerGatewayIp。
400InvalidPeerGatewayIp.MalformedThe specified PeerGatewayIp is not valid.参数PeerGatewayIp的值不合法。
400MissingParameterThe input parameter 'PeeringSubnetMask' that is mandatory for processing this request is not supplied.必须指定参数PeeringSubnetMask。
400InvalidPeeringSubnetMask.MalformedThe specified PeeringSubnetMask is not valid.指定的PeeringSubnetMask不合法,请您检查该参数是否正确。
400InvalidName.MalformedThe specified ?Name? is not valid.该名称格式不合法。
400InvalidDescription.MalformedThe specifid ?Description? is not valid.指定的资源描述格式不合法。长度为2~256个字符,不能以http://和https://开头。
400QuotaExceeded.vbrPerpConnVirtual boarder router per PhysicalConnection quota exceed.超过了每个物理专线上的边界路由器配额上限,请您减少该物理专线上的边界路由器数量后再试。
400EXCEED_ASSOCIATE_MAX_NUMassocaite virtual boarder num too many.关联的边界路由器达到配额上限。
400InvalidIP.MalformedIp malformed.IP格式不合法。
400MissingParameterLocalGatewayIp, peerGatewayIp and peeringSubnetMask must not be null.参数缺失LocalGatewayIp,peerGatewayIp,peeringSubnetMask不能为空
400InvalidIp.NotSameSubnetLocal gateway ip and peer gateway ip are not in the same subnet.本地网关IP地址与对端网关IP地址不在同一个子网内。
400InvalidStatus.StatusNotEnabledThe physical connection status is invalid.物理专线状态不支持此操作,请检查物理专线状态。
400InvalidParams.AlreadyExistsphysical connection has already associated with vbr.-
400PHYSICAL_NOT_ALLOW_ASSOCIATE_VBRThe specified operation not allow.无法执行该操作,物理专线有关联的边界路由器。
400Forbidden.OperationNotAllowedThe caller must be PhysicalConnection or VirtualBorderRouter's owner.-
400Forbidden.NotSameAccessDeviceVbr and physicalConnection are not on the same accessDevice.Vbr和物理连接不在同一访问设备上。
400Duplicated.LocalGatewayIpVbr has conflict local gateway ip.-
400OperationFailed.VlanIdInUseOperation failed because vlanId is in use.vlanId已经被使用
400OperationFailed.PconnTrafficNotEnableThe operation is failed because of PconnTrafficNotEnable.操作失败,因为出方向流量未开通。
400DuplicatedParam.LocalGatewayIpDuplicated LocalGatewayIp values.本端Ip重复。
400DuplicatedParam.PeerGatewayIpDuplicated PeerGatewayIp values.互联ip地址重复,请更换后重试。
400DuplicatedParam.LocalIpv6GatewayIpDuplicated LocalIpv6GatewayIp values.本端ip地址重复。
400DuplicatedParam.PeerIpv6GatewayIpDuplicated PeerIpv6GatewayIp values.对端ip地址重复。
400EcPconnVbrMustContainsAllIn the single VBR with multiple Pconn scene, all Pconn must be associated with the same Qos.单VBR多Pconn场景,必须将所有的Pconn都绑定QoS策略。
403Forbidden.OperationNotAllowedByUserThe caller is not allowed to delete the specified VirtualBorderRouter.不允许删除边界路由器。
403Forbidden.MultiVlanRiMultiple vlan router interfaces are found.存在多个VLAN路由器接口。
403Forbidden.NoRiFoundNo vlan router interfaces are found.没有可用的VLAN路由器接口。
403Forbidden.LocalGatewayIpNotAllowedByCallerThe caller is not allowed to specify the LocalGatewayIp parameter.不允许指定LocalGatewayIp参数。
403Forbidden.PeerGatewayIpNotAllowedByCallerThe caller is not allowed to specify the PeerGatewayIp parameter.不允许指定PeerGatewayIp参数。
403Forbidden.PeeringSubnetMaskNotAllowedByCallerThe caller is not allowed to specify the PeeringSubnetMask parameter.不允许指定PeeringSubnetMask参数。
403Forbidden.NameNotAllowedByCallerThe caller is not allowed to specify the Name parameter.不允许指定Name参数。
403Forbidden.DescriptionNotAllowedByCallerThe caller is not allowed to specify the Description parameter.不允许指定Description参数。
404InvalidInstanceId.NotFoundThe specified Instance does not exist in the specified region.该实例在该地域内不存在。
404InvalidRegionId.NotFoundThe RegionId provided does not exist in our records.指定的RegionId不存在。请检查该参数是否正确。
404InvalidVbrId.NotFoundThe specified VirutalBorderRouter does not exist in our records.该边界路由器不存在,请您检查输入的边界路由器是否正确。
404InvalidRegionId.NotFoundThe specified RegionId is not found.指定的RegionId不存在,请您检查此产品在该地域是否可用。
404InvalidVbrOwnerId.NotFoundThe specified VbrOwnerId is not valid.参数VbrOwnerId的值不合法。

访问错误中心查看更多错误码。

变更历史

变更时间变更内容概要操作
2024-02-01OpenAPI 描述信息更新、OpenAPI 错误码发生变更看变更集
变更项变更内容
API 描述OpenAPI 描述信息更新
错误码OpenAPI 错误码发生变更
    错误码 400 变更
    删除错误码:403
    删除错误码:404
2023-04-10OpenAPI 错误码发生变更看变更集
变更项变更内容
错误码OpenAPI 错误码发生变更
    错误码 400 变更
    删除错误码:403
    删除错误码:404