Deletes a custom route entry from a route table.
Before you begin
Note the following before deleting a route entry:
- You can only delete a route entry that is in the available state.
- You cannot delete a route entry from a VPC that is having a VSwitch or route entry created or deleted.
Make the API call
Request parameters
Parameter | Type | Required? | Example value | Description |
---|---|---|---|---|
Action | String | Yes | DeleteRouteEntry |
The name of this action. Value: DeleteRouteEntry |
RegionId | String | Yes | cn-hangzhou |
The ID of the region to which the route table belongs. To query the region ID, call DescribeRegions. |
DestinationCidrBlock | String | No | 0.0.0.0/0 |
The destination CIDR block of the route entry. IPv4 and IPv6 CIDR blocks are supported. |
NextHopId | String | No | ngw-bp1vpo4l2vd7zef8o**** |
The instance ID of the next hop. |
NextHopList.N.NextHopId | String | No | ri-2zeo3xzyf38r43cd**** |
The ID of the next-hop instance of the ECMP route. |
NextHopList.N.NextHopType | String | No | RouterInterface |
The type of the next hop of the ECMP route. Valid value: RouterInterface (router interface). |
RouteEntryId | String | No | rte-bp1mnnr2al0naomn**** |
The ID of the route entry to be deleted. |
RouteTableId | String | No | vtb-hp37isva36oj7839j**** |
The ID of the route table to which the route entry belongs. |
Response parameters
Parameter | Type | Example value | Description |
---|---|---|---|
RequestId | String | 0ED8D006-F706-4D23-88ED-E11ED28DCAC0 |
The ID of the request. |
Examples
Request example
https://vpc.aliyuncs.com/?Action=DeleteRouteEntry
&DestinationCidrBlock=0.0.0.0/0
&RouteTableId=trb-2ze3jgygk9bmsj23s****
&<CommonParameters>
Response example
XML
format
<DeleteRouteEntryResponse>
<RequestId>0ED8D006-F706-4D23-88ED-E11ED28DCAC0</RequestId>
</DeleteRouteEntryResponse>
JSON
format
{
"RequestId":"0ED8D006-F706-4D23-88ED-E11ED28DCAC0"
}
Errors
HTTP status code | Error code | Error message | Description |
---|---|---|---|
400 | MissingParameter | Miss mandatory parameter. | One or more required parameters are missing. |
400 | IncorrcetRouteEntryStatus | Some route entry status blocked this operation. | You cannot perform this operation because one or more route entries in the current route table are in the pending or modifying state. |
400 | InvalidCidrBlock.Malformed | Specified CIDR block is not valid. | The specified CIDR format is invalid. |
404 | InvalidRouteTableId.NotFound | Specified route table does not exist. | The specified route table does not exist. |
400 | OperationDenied | Specified operation is denied as route entry type is system. | This operation cannot be performed because the route entry is the system route entry. |
400 | InvalidRouteEntry.NotFound | Route entry not exists. | The specified route entry does not exist. |
400 | InvalidVRouter.NotFound | vRouter not exists. | The specified VRouter does not exist. |
400 | IncorrectRouteEntryStatus | Some route entry status blocked this operation. | You cannot perform this operation because one or more route entries in the current route table are in the pending or modifying state. |
400 | IncorrectRouteEntryStatus | VBR has NotStable route entry. | You cannot perform this operation because one or more route entries in the current VBR are in the pending or modifying state. |
404 | InvalidVpcId.NotFound | Specified value of VpcId is not found in our record. | The specified VPC does not exist. |
400 | IncorrectRouteEntryStatus | Specified routeEntry status error. | You cannot perform this operation because one or more route entries in the current route table are in the pending or modifying state. |
400 | Forbbiden | Specified RouteEntry cannot allowed delete by openApi. | You cannot call this action to delete the specified route entry. |
400 | InvalidNextHop | Specified nexthop and nexthop list cannot both null. | The next hop and next hop list cannot be empty at the same time. |
400 | InvalidRouteEntry | Specified routeEntry not exist. | The specified route entry does not exist. |
400 | IncorrectVpcStatus | Current VPC status does not support this operation. | The current status of the VPC does not support the action. |
For a list of error codes, visit the API Error Center.