调用DescribeVirtualBorderRoutersForPhysicalConnection接口查询指定物理专线下的VBR实例,包括物理专线所有者的VBR实例和其他账号的VBR实例。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DescribeVirtualBorderRoutersForPhysicalConnection |
系统规定参数。取值:DescribeVirtualBorderRoutersForPhysicalConnection。 |
RegionId | String | 是 | cn-shanghai |
物理专线所在的地域。 您可以通过调用DescribeRegions 接口获取地域ID。 |
PhysicalConnectionId | String | 是 | pc-119mfj**** |
物理专线的ID。 |
PageNumber | Integer | 否 | 1 |
列表的页码,默认值为1。 |
PageSize | Integer | 否 | 10 |
分页查询时每页的行数,最大值为50。默认值为10。 |
Filter.N.Key | String | 否 | Status |
过滤条件,最多可提供5个过滤条件。支持如下过滤条件:
|
Filter.N.Value.N | String | 否 | Active |
根据Key指定过滤值。一个Key支持指定多个过滤值,每个过滤值之间是或的关系,即只要符合其中一个过滤值,则视为匹配该过滤条件。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | 7C5AE8B3-A2D8-428D-A2FF-93A225C0821E |
请求ID。 |
PageNumber | Integer | 1 |
列表的页码,默认值为1。 |
PageSize | Integer | 10 |
分页查询时每页的行数,最大值:50。默认值:10。 |
TotalCount | Integer | 1 |
列表条目数。 |
VirtualBorderRouterForPhysicalConnectionSet | Array of VirtualBorderRouterForPhysicalConnectionType |
查询到的VBR实例信息合集。 |
|
VirtualBorderRouterForPhysicalConnectionType | |||
Status | String | Active |
VBR实例状态。取值:
|
CreationTime | String | 2021-06-08T12:20:55 |
创建VBR的时间。 |
Type | String | pconnVBR |
VBR类型。 |
PeerIpv6GatewayIp | String | 2001:XXXX:3c4d:0015:0000:0000:0000:1a2b |
VBR实例的客户侧互联IPv6地址。 为物理专线所有者创建VBR实例时必填,为其他账号创建VBR实例时无需填写。 |
CircuitCode | String | longtel0** |
运营商为物理专线提供的电路编码。 |
LocalIpv6GatewayIp | String | ipv6bw-uf6hcyzu65v98v3du**** |
VBR实例的阿里云侧互联IPv6地址。 |
PConnVbrExpireTime | String | 2021-06-10T12:20:55 |
物理专线绑定的VBR到期时间。 |
LocalGatewayIp | String | 192.168.XX.X |
VBR实例的阿里云侧互联IPv4地址。 |
BandwidthStatus | String | Active |
带宽生效状态。取值:
|
ActivationTime | String | 2021-06-08T12:20:55 |
VBR第一次激活的时间。 |
VbrOwnerUid | Long | 253460731706911258 |
VBR所有者的账号ID。 VBR和物理专线的所有者相同时该参数为空。 |
PeeringSubnetMask | String | 255.255.255.0 |
VBR实例的阿里云侧和客户侧互联IPv4的子网掩码。 两个IPv4地址必须位于同一个子网。 |
EnableIpv6 | Boolean | true |
是否启用IPv6。取值:
|
EccId | String | ecc-sjghe**** |
高速上云服务实例ID。 |
Bandwidth | String | 10 |
物理专线下绑定的边界路由器带宽值,单位:Mbps。 |
RecoveryTime | String | 2021-06-08T12:20:55 |
VBR最近一次从Terminated状态恢复到Active状态的时间。 |
TerminationTime | String | 2021-06-07T12:20:55 |
VBR最近一次被终止的时间。 |
PConnVbrBussinessStatus | String | Normal |
物理专线绑定的VBR运行状态。取值:
|
PeerGatewayIp | String | 162.62.XX.XX |
VBR实例的客户侧互联IPv4地址。 |
PeeringIpv6SubnetMask | String | 2408:4004:cc:400::/56 |
VBR实例的阿里云侧和客户侧互联IPv6的子网掩码。 两个IPv6地址必须位于同一个子网。 |
VbrId | String | vbr-bp16ksp61j7e0tk**** |
VBR实例ID。 |
PConnVbrChargeType | String | PrePaid |
物理专线绑定的边界路由器付费类型。取值:
|
VlanId | Integer | 1678 |
VBR实例的VLAN ID。 |
示例
请求示例
http(s)://[Endpoint]/?Action=DescribeVirtualBorderRoutersForPhysicalConnection
&RegionId=cn-shanghai
&PhysicalConnectionId=pc-119mfj****
&PageNumber=1
&PageSize=10
&Filter=[{"Key":"Status","Value":["Active"]}]
&公共请求参数
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<DescribeVirtualBorderRoutersForPhysicalConnectionResponse>
<RequestId>7C5AE8B3-A2D8-428D-A2FF-93A225C0821E</RequestId>
<PageNumber>1</PageNumber>
<PageSize>10</PageSize>
<TotalCount>1</TotalCount>
<VirtualBorderRouterForPhysicalConnectionSet>
<Status>Active</Status>
<CreationTime>2021-06-08T12:20:55</CreationTime>
<Type>pconnVBR</Type>
<PeerIpv6GatewayIp>2001:XXXX:3c4d:0015:0000:0000:0000:1a2b</PeerIpv6GatewayIp>
<CircuitCode>longtel0**</CircuitCode>
<LocalIpv6GatewayIp>ipv6bw-uf6hcyzu65v98v3du****</LocalIpv6GatewayIp>
<PConnVbrExpireTime>2021-06-10T12:20:55</PConnVbrExpireTime>
<LocalGatewayIp>192.168.XX.X</LocalGatewayIp>
<BandwidthStatus>Active</BandwidthStatus>
<ActivationTime>2021-06-08T12:20:55</ActivationTime>
<VbrOwnerUid>253460731706911260</VbrOwnerUid>
<PeeringSubnetMask>255.255.255.0</PeeringSubnetMask>
<EnableIpv6>true</EnableIpv6>
<EccId>ecc-sjghe****</EccId>
<Bandwidth>10</Bandwidth>
<RecoveryTime>2021-06-08T12:20:55</RecoveryTime>
<TerminationTime>2021-06-07T12:20:55</TerminationTime>
<PConnVbrBussinessStatus>Normal</PConnVbrBussinessStatus>
<PeerGatewayIp>162.62.XX.XX</PeerGatewayIp>
<PeeringIpv6SubnetMask>2408:4004:cc:400::/56</PeeringIpv6SubnetMask>
<VbrId>vbr-bp16ksp61j7e0tk****</VbrId>
<PConnVbrChargeType>PrePaid</PConnVbrChargeType>
<VlanId>1678</VlanId>
</VirtualBorderRouterForPhysicalConnectionSet>
</DescribeVirtualBorderRoutersForPhysicalConnectionResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "7C5AE8B3-A2D8-428D-A2FF-93A225C0821E",
"PageNumber" : 1,
"PageSize" : 10,
"TotalCount" : 1,
"VirtualBorderRouterForPhysicalConnectionSet" : [ {
"Status" : "Active",
"CreationTime" : "2021-06-08T12:20:55",
"Type" : "pconnVBR",
"PeerIpv6GatewayIp" : "2001:XXXX:3c4d:0015:0000:0000:0000:1a2b",
"CircuitCode" : "longtel0**",
"LocalIpv6GatewayIp" : "ipv6bw-uf6hcyzu65v98v3du****",
"PConnVbrExpireTime" : "2021-06-10T12:20:55",
"LocalGatewayIp" : "192.168.XX.X",
"BandwidthStatus" : "Active",
"ActivationTime" : "2021-06-08T12:20:55",
"VbrOwnerUid" : 253460731706911260,
"PeeringSubnetMask" : "255.255.255.0",
"EnableIpv6" : true,
"EccId" : "ecc-sjghe****",
"Bandwidth" : "10",
"RecoveryTime" : "2021-06-08T12:20:55",
"TerminationTime" : "2021-06-07T12:20:55",
"PConnVbrBussinessStatus" : "Normal",
"PeerGatewayIp" : "162.62.XX.XX",
"PeeringIpv6SubnetMask" : "2408:4004:cc:400::/56",
"VbrId" : "vbr-bp16ksp61j7e0tk****",
"PConnVbrChargeType" : "PrePaid",
"VlanId" : 1678
} ]
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | InvalidPhysicalConnectionId.NotFound | The specified physicalConnection is not found. | 没有找到此专线ID对应的物理专线。 |
404 | InvalidPhysicalConnectionId.NotFound | The specified PhysicalConnectionId does not belong to user. | 该物理专线不属于您的账号。 |
访问错误中心查看更多错误码。