NSX-T Data Center REST API

Get forwarding table from tier-0 in CSV format

Get forwarding table from tier-0 gateway in CSV format.

Request:

Method:

GET

URI Path(s):

/policy/api/v1/infra/tier-0s/{tier-0-id}/forwarding-table?format=csv
/policy/api/v1/global-infra/tier-0s/{tier-0-id}/forwarding-table?format=csv

Request Headers:

n/a

Query Parameters:

RoutesRequestParameters+

RoutesRequestParameters (schema)

Name	Description	Type	Notes
component_type	Define the DR routes. Component type define to take the route from CCP.	string	Enum: DR_ROUTES
cursor	Opaque cursor to be used for getting next page of records (supplied by current result page)	string
edge_id	UUID of edge node UUID of edge node. Edge should be member of enforcement point.	string
edge_path	Policy path of edge node Policy path of edge node. Edge should be member of enforcement point.	string
enforcement_point_path	Enforcement point path String Path of the enforcement point. When not specified, routes from all enforcement-points are returned. This property is required for retrieving routes in CSV format.	string
included_fields	Comma separated list of fields that should be included in query result Note - this parameter currently only works when used with the search APIs /policy/api/v1/search/query and /policy/api/v1/search/dsl. It is ignored for other list APIs.	string
network_prefix	Network address filter parameter IPAddress or CIDR network address to filter entries in the table.	IPAddressOrCIDRBlock
page_size	Maximum number of results to return in this page (server may return fewer)	integer	Minimum: 0 Maximum: 1000 Default: "1000"
route_source	Filter routes based on the source from which route is learned Filter routes based on the source from which route is learned.	string	Enum: BGP, STATIC, CONNECTED, OSPF
sort_ascending		boolean
sort_by	Field by which records are sorted	string

Request Body:

n/a

Successful Response:

Response Code:

200 OK

Response Headers:

Content-type: text/csv

Response Body:

GatewayRouteTableInCsvFormat+

GatewayRouteTableInCsvFormat (schema)

Name	Description	Type	Notes
file_name	File name File name set by HTTP server if API returns CSV result as a file.	string
last_update_timestamp	Timestamp when the data was last updated; unset if data source has never updated the data.	EpochMsTimestamp	Readonly
results		array of GatewayRouteCsvRecord

Example Response:

transport_node_path,edge_path,route_type,network,interface,next_hop,admin_distance,lr_component_id,lr_component_type,next_hop_gateway,black_hole ,"/infra/sites/default/enforcement-points/default/edge-clusters/EDGECLUSTER1/edge-nodes/0",route,11.11.10.0/32,"/infra/tier-0s/ExternalTOR/locale-services/Tier0LS-ExternalTOR/interfaces/ToProvider",40.40.40.12,0,"3e55b96e-e0ab-4aa5-85c6-83e3d49aa6d5","CCP_ROUTER_TYPE_SERVICE_ROUTER_TIER0",,false ,"/infra/sites/default/enforcement-points/default/edge-clusters/EDGECLUSTER1/edge-nodes/0",route,11.11.40.0/28,"/infra/tier-0s/ExternalTOR/locale-services/Tier0LS-ExternalTOR/interfaces/INTERVRF",169.254.2.1,0,"3e55b96e-e0ab-4aa5-85c6-83e3d49aa6d5","CCP_ROUTER_TYPE_SERVICE_ROUTER_TIER0","/orgs/default/projects/default/transit-gateways/default",false ,"/infra/sites/default/enforcement-points/default/edge-clusters/EDGECLUSTER1/edge-nodes/0",route,"fc20:b49a:e000:fde8:50:56ff:fe56:5401/128","070d7c61-f14a-56d7-a632-841901a516a4",,0,"52b08d56-2b70-4e55-8914-ea1d4b68f005","CCP_ROUTER_TYPE_DISTRIBUTED_ROUTER_TIER0",,false

Required Permissions:

read

Feature:

policy_statistics

Additional Errors:

• 404 Not Found
• 301 Moved Permanently
• 307 Temporary Redirect
• 400 Bad Request
• 403 Forbidden
• 409 Conflict
• 412 Precondition Failed
• 500 Internal Server Error
• 503 Service Unavailable