Skip to content
StratumStratum Docs

List route tables in a project.

GET
/v1/projects/{projectId}/network/route-tables
Code sample: Shell / cURL
curl --request GET \
  --url https://stratum.example.com/v1/projects/example/network/route-tables \
  --header 'Authorization: Bearer <token>'

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
projectId
required
string
/^p-[a-z0-9-]+$/

Query Parameters

Section titled “Query Parameters”
vpcId
string
/^vpc-[a-z0-9-]+$/

Responses

Section titled “Responses”

200

Section titled “200”

Route tables.

Media typeapplication/json
object
items
required
Array<object>
object
id
required
string
/^rtb-[a-z0-9-]+$/
projectId
required
string
vpcId
required
string
/^vpc-[a-z0-9-]+$/
name
required
string
main
required

True for the VPC’s main route table (auto-created with the VPC; subnets not explicitly associated with a custom table use it). The main table cannot be deleted.

boolean
routes
required
Array<object>
object
destinationCidr
required

IPv4 CIDR this route matches on the destination address. Must not lie inside the VPC CIDR (intra-VPC routing is implicit) or link-local space; broad routes containing them (e.g. 0.0.0.0/0) are fine — local traffic always wins, as with AWS’s non-overridable local route.

string
/^([0-9]{1,3}\.){3}[0-9]{1,3}/[0-9]+$/
targetType
required
string
Allowed values: internetGateway networkInterface instance natGateway vpcPeering
targetId

Target resource ID. Required for every target type except internetGateway (a VPC has at most one implicit IGW). For instance targets this is the instance ID; the route resolves to its primary NIC.

string
state

Server-populated; ignored on input. A route whose target no longer exists is reported as blackhole and not programmed into the fabric.

string
Allowed values: active blackhole
subnetIds

Subnets currently associated with this table.

Array<string>
state
required
string
Allowed values: available deleting deleted
tags

AWS-shape resource tags. Freeform UTF-8 keys (1-128 bytes, no leading/trailing whitespace) mapped to freeform UTF-8 values (0-256 bytes). Max 50 tags per resource. Reserved prefixes (stratum.dev/, stratum.platform_health., stratum:, aws:) return 400 RESERVED_NAMESPACE on customer input. PATCH replaces the whole map..

object
<= 50 properties
key
additional properties
string
<= 256 characters
createdAt
required
string format: date-time
updatedAt
required
string format: date-time
deletedAt
string format: date-time
createdBy
string
nextPageToken
string
isTruncated

True when the server had more rows than it returned. The response is a valid prefix of the result, not the whole of it.

Without this flag a client at the server’s row ceiling receives a full page and no nextPageToken, which means “this is the complete set” — so data it never saw would be indistinguishable from data that does not exist.

It does not imply a cursor exists. These queries do not all sort on a total order, so a resumable token cannot be minted for them yet. The remedy is to narrow the request (a filter, or a tighter scope), not to page.

boolean

Example 

{
  "items": [
    {
      "routes": [
        {
          "targetType": "internetGateway",
          "state": "active"
        }
      ],
      "state": "available"
    }
  ]
}