Creates a new route in a route table within a VPC. The route’s target can be either a gateway attached to the VPC or a NAT instance in the VPC.
When determining how to route traffic, we use the route with the most specific match. For
example, let’s say the traffic is destined for 192.0.2.3
, and the route table
includes the following two routes:
192.0.2.0/24
(goes to some target A)192.0.2.0/28
(goes to some target B)
Both routes apply to the traffic destined for 192.0.2.3
. However, the second route
in the list is more specific, so we use that route to determine where to target the traffic.
For more information about route tables, go to Route Tables in the Amazon Virtual Private Cloud User Guide.
Access
public
Parameters
Parameter |
Type |
Required |
Description |
---|---|---|---|
|
Required |
The ID of the route table where the route will be added. |
|
|
Required |
The CIDR address block used for the destination match. For example: |
|
|
Optional |
An associative array of parameters that can have the following keys:
|
Returns
Type |
Description |
---|---|
A |
Examples
Create a new VPC route.
Here is the flow:
- Create a new VPC with
create_vpc()
and a CIDR block. - Create a new Route Table with
create_route_table()
. - Create a new Internet Gateway with
create_internet_gateway()
. - Attach the Internet Gateway to the VPC with
attach_internet_gateway()
. - Create a new Route with
create_route()
.
$ec2 = new AmazonEC2(); $response = $ec2->create_route('rtb-e68b0b8f', '0.0.0.0/0', array( 'GatewayId' => 'igw-8c8e0ee5' )); var_dump($response->isOK());Result:
bool(true)
Related Methods
Source
Method defined in services/ec2.class.php | Toggle source view (8 lines) | View on GitHub