DescribeRouteTables

GET /?Action=DescribeRouteTables
Description

Describes one or more of your route tables.
In your Virtual Private Cloud (VPC), each subnet must be associated with a route table. If a subnet is not explicitly associated with a route table, it is implicitly associated with the main route table of the VPC.
You can use the Filter.N parameter to filter the route tables on the following properties:

  • association.route-table-association-id: The ID of an association ID for the route table.

  • association.route-table-id: The ID of the route table involved in the association.

  • association.subnet-id: The ID of the subnet involved in the association.

  • association.main: Indicates whether the route table is the main route table for the VPC (true | false).

  • route-table-id: The ID of the route table.

  • route.destination-cidr-block: The CIDR range specified in a route in the table.

  • route.destination-prefix-list-id: The prefix ID of the service specified in a route in the table.

  • route.gateway-id: The ID of a gateway specified in a route in the table.

  • route.instance-id: The ID of an instance specified in a route in the table.

  • route.nat-gateway-id: The ID of a NAT gateway specified in a route in the table.

  • route.origin: How the route was created.

  • route.state: The state of a route in the route table (active | blackhole). The blackhole state indicates that the target of the route is not available.

  • route.vpc-peering-connection-id: The ID of a VPC peering connection specified in a route in the table.

  • tag-key: The key of a tag associated with the resource.

  • tag-value: The value of a tag associated with the resource.

  • tag:XXXX: The value of a tag associated with the resource, where XXXX is the key of the tag.

  • vpc-id: The ID of the VPC for the route table.

Note

If you exceed the number of identical requests allowed for a configured time period, the RequestLimitExceeded error message is returned.
Body parameter

Required: false
Name: DescribeRouteTablesRequest

Name Description Required Schema Default Example

Filter.N

One or more filters. Example:
osc-cli fcu DescribeRouteTables \
  --Filter.1.Name "tag:KEYOFTHETAG" \
  --Filter.1.Value.1 "VALUEOFTHETAG"

false

Filter

RouteTableId.N

One or more route table IDs.

false

string
Responses
HTTP Code 200
HTTP Code Description Schema

200

DescribeRouteTablesResult

Response 200

Response 200

Name Description Required Schema Default Example

requestId

The ID of the request.

false

string

routeTableSet.N

Information about one or more route tables.

false

RouteTable