Amazon EC2 Ec2 Route Table API
The Ec2 Route Table API from Amazon EC2 — 5 operation(s) for ec2 route table.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/amazon-ec2:amazon-ec2-route-table-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Amazon Elastic Compute Cloud Route Table API
version: '2016-11-15'
description: Generated from AWS's published Smithy model for Amazon Elastic Compute Cloud. 5 operation(s).
contact:
name: Amazon Web Services
url: https://aws.amazon.com/contact-us/
license:
name: Apache 2.0
identifier: Apache-2.0
url: https://github.com/aws/api-models-aws/blob/main/LICENSE
servers:
- url: https://ec2.{region}.amazonaws.com
variables:
region:
default: us-east-1
security:
- sigv4: []
tags:
- name: Route Table
paths:
/?Action=AssociateRouteTable:
post:
operationId: AssociateRouteTable
summary: Associate Route Table
description: Associates a subnet in your VPC or an internet gateway or virtual private gateway attached to your VPC with a route table in your VPC. This association causes traffic from the subnet or gateway to be routed according to the routes in the route table. The action returns an association ID, which you need in order to disassociate the route table later. A route table can be associated with multiple subnets. For more information, see Route tables in the Amazon VPC User Guide.
responses:
'200':
description: Success
content:
text/xml:
schema:
$ref: '#/components/schemas/AssociateRouteTableResult'
example:
AssociationId: rtbassoc-781d0d1a
requestBody:
required: true
content:
application/x-www-form-urlencoded:
schema:
allOf:
- type: object
required:
- Action
- Version
properties:
Action:
type: string
const: AssociateRouteTable
Version:
type: string
const: '2016-11-15'
- $ref: '#/components/schemas/AssociateRouteTableRequest'
example:
SubnetId: subnet-9d4a7b6
RouteTableId: rtb-22574640
tags:
- Route Table
/?Action=CreateRouteTable:
post:
operationId: CreateRouteTable
summary: Create Route Table
description: Creates a route table for the specified VPC. After you create a route table, you can add routes and associate the table with a subnet. For more information, see Route tables in the Amazon VPC User Guide.
responses:
'200':
description: Success
content:
text/xml:
schema:
$ref: '#/components/schemas/CreateRouteTableResult'
example:
RouteTable:
Associations: []
RouteTableId: rtb-22574640
VpcId: vpc-a01106c2
PropagatingVgws: []
Tags: []
Routes:
- GatewayId: local
DestinationCidrBlock: 10.0.0.0/16
State: active
requestBody:
required: true
content:
application/x-www-form-urlencoded:
schema:
allOf:
- type: object
required:
- Action
- Version
properties:
Action:
type: string
const: CreateRouteTable
Version:
type: string
const: '2016-11-15'
- $ref: '#/components/schemas/CreateRouteTableRequest'
example:
VpcId: vpc-a01106c2
tags:
- Route Table
/?Action=DeleteRouteTable:
post:
operationId: DeleteRouteTable
summary: Delete Route Table
description: Deletes the specified route table. You must disassociate the route table from any subnets before you can delete it. You can't delete the main route table.
responses:
'200':
description: Success
content:
text/xml:
schema:
type: string
requestBody:
required: true
content:
application/x-www-form-urlencoded:
schema:
allOf:
- type: object
required:
- Action
- Version
properties:
Action:
type: string
const: DeleteRouteTable
Version:
type: string
const: '2016-11-15'
- $ref: '#/components/schemas/DeleteRouteTableRequest'
example:
RouteTableId: rtb-22574640
tags:
- Route Table
/?Action=DescribeRouteTables:
post:
operationId: DescribeRouteTables
summary: Describe Route Tables
description: Describes your route tables. The default is to describe all your route tables. Alternatively, you can specify specific route table IDs or filter the results to include only the route tables that match specific criteria. Each subnet in your VPC must be associated with a route table. If a subnet is not explicitly associated with any route table, it is implicitly associated with the main route table. This command does not return the subnet ID for implicit associations. For more information, see Route tables in the Amazon VPC User Guide.
responses:
'200':
description: Success
content:
text/xml:
schema:
$ref: '#/components/schemas/DescribeRouteTablesResult'
example:
RouteTables:
- Associations:
- RouteTableAssociationId: rtbassoc-d8ccddba
Main: true
RouteTableId: rtb-1f382e7d
RouteTableId: rtb-1f382e7d
VpcId: vpc-a01106c2
PropagatingVgws: []
Tags: []
Routes:
- GatewayId: local
DestinationCidrBlock: 10.0.0.0/16
State: active
requestBody:
required: true
content:
application/x-www-form-urlencoded:
schema:
allOf:
- type: object
required:
- Action
- Version
properties:
Action:
type: string
const: DescribeRouteTables
Version:
type: string
const: '2016-11-15'
- $ref: '#/components/schemas/DescribeRouteTablesRequest'
example:
RouteTableIds:
- rtb-1f382e7d
tags:
- Route Table
/?Action=DisassociateRouteTable:
post:
operationId: DisassociateRouteTable
summary: Disassociate Route Table
description: Disassociates a subnet or gateway from a route table. After you perform this action, the subnet no longer uses the routes in the route table. Instead, it uses the routes in the VPC's main route table. For more information about route tables, see Route tables in the Amazon VPC User Guide.
responses:
'200':
description: Success
content:
text/xml:
schema:
type: string
requestBody:
required: true
content:
application/x-www-form-urlencoded:
schema:
allOf:
- type: object
required:
- Action
- Version
properties:
Action:
type: string
const: DisassociateRouteTable
Version:
type: string
const: '2016-11-15'
- $ref: '#/components/schemas/DisassociateRouteTableRequest'
example:
AssociationId: rtbassoc-781d0d1a
tags:
- Route Table
components:
schemas:
DescribeRouteTablesRequest:
type: object
properties:
NextToken:
type: string
description: The token returned from a previous paginated request. Pagination continues from the end of the items returned by the previous request.
MaxResults:
type: integer
description: The maximum number of items to return for this request. To get the next page of items, make another request with the token returned in the output. For more information, see Pagination.
DryRun:
type: boolean
description: Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.
RouteTableIds:
type: array
items:
type: string
description: The IDs of the route tables.
Filters:
type: array
items:
$ref: '#/components/schemas/Filter'
description: The filters. association.gateway-id - The ID of the gateway involved in the association. 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 tables that do not have an association ID are not returned in the response. owner-id - The ID of the Amazon Web Services account that owns the route tab
CreateRouteTableRequest:
type: object
properties:
TagSpecifications:
type: array
items:
$ref: '#/components/schemas/TagSpecification'
description: The tags to assign to the route table.
ClientToken:
type: string
description: Unique, case-sensitive identifier that you provide to ensure the idempotency of the request. For more information, see Ensuring idempotency.
DryRun:
type: boolean
description: Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.
VpcId:
type: string
description: The ID of the VPC.
required:
- VpcId
AssociateRouteTableRequest:
type: object
properties:
GatewayId:
type: string
description: The ID of the internet gateway or virtual private gateway.
PublicIpv4Pool:
type: string
description: The ID of a public IPv4 pool. A public IPv4 pool is a pool of IPv4 addresses that you've brought to Amazon Web Services with BYOIP.
DryRun:
type: boolean
description: Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.
SubnetId:
type: string
description: The ID of the subnet.
RouteTableId:
type: string
description: The ID of the route table.
required:
- RouteTableId
DeleteRouteTableRequest:
type: object
properties:
DryRun:
type: boolean
description: Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.
RouteTableId:
type: string
description: The ID of the route table.
required:
- RouteTableId
Tag:
type: object
properties:
Key:
type: string
description: 'The key of the tag. Constraints: Tag keys are case-sensitive and accept a maximum of 127 Unicode characters. May not begin with aws:.'
Value:
type: string
description: 'The value of the tag. Constraints: Tag values are case-sensitive and accept a maximum of 256 Unicode characters.'
CreateRouteTableResult:
type: object
properties:
RouteTable:
$ref: '#/components/schemas/RouteTable'
ClientToken:
type: string
description: Unique, case-sensitive identifier to ensure the idempotency of the request. Only returned if a client token was provided in the request.
Route:
type: object
properties:
DestinationCidrBlock:
type: string
description: The IPv4 CIDR block used for the destination match.
DestinationIpv6CidrBlock:
type: string
description: The IPv6 CIDR block used for the destination match.
DestinationPrefixListId:
type: string
description: The prefix of the Amazon Web Services service.
EgressOnlyInternetGatewayId:
type: string
description: The ID of the egress-only internet gateway.
GatewayId:
type: string
description: The ID of a gateway attached to your VPC.
InstanceId:
type: string
description: The ID of a NAT instance in your VPC.
InstanceOwnerId:
type: string
description: The ID of Amazon Web Services account that owns the instance.
NatGatewayId:
type: string
description: The ID of a NAT gateway.
TransitGatewayId:
type: string
description: The ID of a transit gateway.
LocalGatewayId:
type: string
description: The ID of the local gateway.
CarrierGatewayId:
type: string
description: The ID of the carrier gateway.
NetworkInterfaceId:
type: string
description: The ID of the network interface.
Origin:
type: string
enum:
- CreateRouteTable
- CreateRoute
- EnableVgwRoutePropagation
- Advertisement
description: Describes how the route was created. CreateRouteTable - The route was automatically created when the route table was created. CreateRoute - The route was manually added to the route table. EnableVgwRoutePropagation - The route was propagated by route propagation. Advertisement - The route was created dynamically by Amazon VPC Route Server.
State:
type: string
enum:
- active
- blackhole
- filtered
description: The state of the route. The blackhole state indicates that the route's target isn't available (for example, the specified gateway isn't attached to the VPC, or the specified NAT instance has been terminated).
VpcPeeringConnectionId:
type: string
description: The ID of a VPC peering connection.
CoreNetworkArn:
type: string
description: The Amazon Resource Name (ARN) of the core network.
OdbNetworkArn:
type: string
description: The Amazon Resource Name (ARN) of the ODB network.
IpAddress:
type: string
description: The next hop IP address for routes propagated by VPC Route Server into VPC route tables.
RouteTableAssociationState:
type: object
properties:
State:
type: string
enum:
- associating
- associated
- disassociating
- disassociated
- failed
description: The state of the association.
StatusMessage:
type: string
description: The status message, if applicable.
DisassociateRouteTableRequest:
type: object
properties:
DryRun:
type: boolean
description: Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.
AssociationId:
type: string
description: The association ID representing the current association between the route table and subnet or gateway.
required:
- AssociationId
RouteTableAssociation:
type: object
properties:
Main:
type: boolean
description: Indicates whether this is the main route table.
RouteTableAssociationId:
type: string
description: The ID of the association.
RouteTableId:
type: string
description: The ID of the route table.
SubnetId:
type: string
description: The ID of the subnet. A subnet ID is not returned for an implicit association.
GatewayId:
type: string
description: The ID of the internet gateway or virtual private gateway.
PublicIpv4Pool:
type: string
description: The ID of a public IPv4 pool. A public IPv4 pool is a pool of IPv4 addresses that you've brought to Amazon Web Services with BYOIP.
AssociationState:
$ref: '#/components/schemas/RouteTableAssociationState'
RouteTable:
type: object
properties:
Associations:
type: array
items:
$ref: '#/components/schemas/RouteTableAssociation'
description: The associations between the route table and your subnets or gateways.
PropagatingVgws:
type: array
items:
$ref: '#/components/schemas/PropagatingVgw'
description: Any virtual private gateway (VGW) propagating routes.
RouteTableId:
type: string
description: The ID of the route table.
Routes:
type: array
items:
$ref: '#/components/schemas/Route'
description: The routes in the route table.
Tags:
type: array
items:
$ref: '#/components/schemas/Tag'
description: Any tags assigned to the route table.
VpcId:
type: string
description: The ID of the VPC.
OwnerId:
type: string
description: The ID of the Amazon Web Services account that owns the route table.
AssociateRouteTableResult:
type: object
properties:
AssociationId:
type: string
description: The route table association ID. This ID is required for disassociating the route table.
AssociationState:
$ref: '#/components/schemas/RouteTableAssociationState'
TagSpecification:
type: object
properties:
ResourceType:
type: string
enum:
- capacity-reservation
- client-vpn-endpoint
- customer-gateway
- carrier-gateway
- coip-pool
- declarative-policies-report
- dedicated-host
- dhcp-options
- egress-only-internet-gateway
- elastic-ip
- elastic-gpu
- export-image-task
- export-instance-task
- fleet
- fpga-image
- host-reservation
- image
- image-usage-report
- import-image-task
- import-snapshot-task
- instance
- instance-event-window
- internet-gateway
- ipam
- ipam-pool
- ipam-scope
- ipv4pool-ec2
- ipv6pool-ec2
- key-pair
- launch-template
- local-gateway
- local-gateway-route-table
- local-gateway-virtual-interface
- local-gateway-virtual-interface-group
- local-gateway-route-table-vpc-association
- local-gateway-route-table-virtual-interface-group-association
- natgateway
- network-acl
- network-interface
- network-insights-analysis
- network-insights-path
- network-insights-access-scope
- network-insights-access-scope-analysis
- outpost-lag
- placement-group
- prefix-list
- replace-root-volume-task
- reserved-instances
- route-table
- security-group
- security-group-rule
- service-link-virtual-interface
- snapshot
- spot-fleet-request
- spot-instances-request
- subnet
- subnet-cidr-reservation
- traffic-mirror-filter
- traffic-mirror-session
- traffic-mirror-target
- transit-gateway
- transit-gateway-attachment
- transit-gateway-connect-peer
- transit-gateway-multicast-domain
- transit-gateway-policy-table
- transit-gateway-metering-policy
- transit-gateway-route-table
- transit-gateway-route-table-announcement
- volume
- vpc
- vpc-endpoint
- vpc-endpoint-connection
- vpc-endpoint-service
- vpc-endpoint-service-permission
- vpc-peering-connection
- vpn-connection
- vpn-gateway
- vpc-flow-log
- capacity-reservation-fleet
- traffic-mirror-filter-rule
- vpc-endpoint-connection-device-type
- verified-access-instance
- verified-access-group
- verified-access-endpoint
- verified-access-policy
- verified-access-trust-provider
- vpn-connection-device-type
- vpc-block-public-access-exclusion
- vpc-encryption-control
- route-server
- route-server-endpoint
- route-server-peer
- ipam-resource-discovery
- ipam-resource-discovery-association
- instance-connect-endpoint
- verified-access-endpoint-target
- ipam-external-resource-verification-token
- capacity-block
- mac-modification-task
- ipam-prefix-list-resolver
- ipam-policy
- ipam-prefix-list-resolver-target
- ipam-internet-registry-association
- secondary-interface
- secondary-network
- secondary-subnet
- capacity-manager-data-export
- vpn-concentrator
- ipam-pool-allocation
- capacity-reservation-cancellation-quote
- application-status-check
- capacity-reservation-modification-quote
description: The type of resource to tag on creation.
Tags:
type: array
items:
$ref: '#/components/schemas/Tag'
description: The tags to apply to the resource.
DescribeRouteTablesResult:
type: object
properties:
RouteTables:
type: array
items:
$ref: '#/components/schemas/RouteTable'
description: Information about the route tables.
NextToken:
type: string
description: The token to include in another request to get the next page of items. This value is null when there are no more items to return.
PropagatingVgw:
type: object
properties:
GatewayId:
type: string
description: The ID of the virtual private gateway.
Filter:
type: object
properties:
Name:
type: string
description: The name of the filter. Filter names are case-sensitive.
Values:
type: array
items:
type: string
description: The filter values. Filter values are case-sensitive. If you specify multiple values for a filter, the values are joined with an OR, and the request returns all results that match any of the specified values.
securitySchemes:
sigv4:
type: apiKey
in: header
name: Authorization
description: AWS Signature Version 4. The Authorization header carries an AWS4-HMAC-SHA256 signature over the canonical request, with X-Amz-Date (and X-Amz-Security-Token for temporary credentials). Not a bearer token.
x-aws-sigv4:
signingName: ec2
x-provenance:
method: harvested
publisher: Amazon Web Services
source: https://raw.githubusercontent.com/aws/api-models-aws/582e55931c45b944739742a2c1620b6026dd2d13/models/ec2/service/2016-11-15/ec2-2016-11-15.json
note: converted by smithy-to-openapi.py from AWS's Smithy model (roadmap#1001)