Queries policy-based routes configured for a VPN gateway.
Debugging
Request parameters
Parameter | Type | Required | Example | Description |
Action | String | Yes | DescribeVpnPbrRouteEntries | The operation that you want to perform. Set the value to DescribeVpnPbrRouteEntries. |
RegionId | String | Yes | eu-central-1 | The ID of the region where the VPN gateway is created. You can call the DescribeRegions operation to query the most recent region list. |
VpnGatewayId | String | Yes | vpn-bp1a3kqjiiq9legfx**** | The ID of the VPN gateway. |
PageNumber | Integer | No | 1 | The number of the returned page. Default value: 1. |
PageSize | Integer | No | 10 | The number of entries per page. Maximum value: 50. Default value: 10. |
Response parameters
Parameter | Type | Example | Description |
PageSize | Integer | 10 | The number of entries per page. |
RequestId | String | 5BE01CD7-5A50-472D-AC14-CA181C5C03BE | The request ID. |
PageNumber | Integer | 1 | The number of the returned page. |
TotalCount | Integer | 1 | The number of entries returned. |
VpnPbrRouteEntries | Array of VpnPbrRouteEntry | The list of policy-based routes. |
|
VpnPbrRouteEntry | |||
NextHop | String | vco-bp15oes1py4i66rmd**** | The next hop of the policy-based route. |
Weight | Integer | 100 | The weight of the policy-based route. Valid values:
|
RouteDest | String | 10.0.0.0/24 | The destination CIDR block of the policy-based route. |
State | String | published | The status of the policy-based route. Valid values:
|
CreateTime | Long | 1492747187000 | The timestamp generated when the policy-based route was created. Unit: milliseconds. This value is a UNIX timestamp representing the number of milliseconds that have elapsed since January 1, 1970, 00:00:00 UTC. |
VpnInstanceId | String | vpn-bp1a3kqjiiq9legfx**** | The ID of the VPN gateway. |
RouteSource | String | 192.168.0.0/24 | The source CIDR block of the policy-based route. |
Priority | Integer | 10 | The priority of the policy-based route. A smaller value indicates a higher priority. |
NextHopTunnelId | String | tun-opsqc4d97wni2**** | The ID of the tunnel associated with the next hop of the policy-based route. This parameter is returned only if the VPN gateway supports the dual-tunnel mode. |
Examples
Sample requests
http(s)://[Endpoint]/?Action=DescribeVpnPbrRouteEntries
&RegionId=eu-central-1
&VpnGatewayId=vpn-bp1a3kqjiiq9legfx****
&PageNumber=1
&PageSize=10
&Common request parameters
Sample success responses
XML
format
HTTP/1.1 200 OK
Content-Type:application/xml
<DescribeVpnPbrRouteEntriesResponse>
<PageSize>10</PageSize>
<RequestId>5BE01CD7-5A50-472D-AC14-CA181C5C03BE</RequestId>
<PageNumber>1</PageNumber>
<TotalCount>1</TotalCount>
<VpnPbrRouteEntries>
<NextHop>vco-bp15oes1py4i66rmd****</NextHop>
<Weight>100</Weight>
<RouteDest>10.0.0.0/24</RouteDest>
<State>published</State>
<CreateTime>1492747187000</CreateTime>
<VpnInstanceId>vpn-bp1a3kqjiiq9legfx****</VpnInstanceId>
<RouteSource>192.168.0.0/24</RouteSource>
<Priority>10</Priority>
<NextHopTunnelId>tun-opsqc4d97wni2****</NextHopTunnelId>
</VpnPbrRouteEntries>
</DescribeVpnPbrRouteEntriesResponse>
JSON
format
HTTP/1.1 200 OK
Content-Type:application/json
{
"PageSize" : 10,
"RequestId" : "5BE01CD7-5A50-472D-AC14-CA181C5C03BE",
"PageNumber" : 1,
"TotalCount" : 1,
"VpnPbrRouteEntries" : [ {
"NextHop" : "vco-bp15oes1py4i66rmd****",
"Weight" : 100,
"RouteDest" : "10.0.0.0/24",
"State" : "published",
"CreateTime" : 1492747187000,
"VpnInstanceId" : "vpn-bp1a3kqjiiq9legfx****",
"RouteSource" : "192.168.0.0/24",
"Priority" : 10,
"NextHopTunnelId" : "tun-opsqc4d97wni2****"
} ]
}
Error codes
HttpCode | Error Code | Error message | Description |
403 | Forbbiden.SubUser | User not authorized to operate on the specified resource as your account is created by another user. | You are unauthorized to perform this operation on the specified resource. You can apply for the required permissions and try again. |
403 | Forbidden | User not authorized to operate on the specified resource. | You are unauthorized to perform this operation on the specified resource. Acquire the required permissions and try again. |
For a list of error codes, see Service error codes.