NSX-T Data Center REST API

List Tunnel

List all policy tunnels(GRE as of now) This API is only available when using VMware NSX.

Request:

Method:
GET
URI Path(s):
/policy/api/v1/infra/tier-0s/{tier-0-id}/locale-services/{locale-svc-id}/tunnels
Request Headers:
n/a
Query Parameters:
PolicyTunnelListRequestParameters+
Request Body:
n/a

Successful Response:

Response Code:
200 OK
Response Headers:
Content-type: application/json
Response Body:
PolicyTunnelListResult+

Example Response:

{ "results": [ { "destination_address": "44.44.44.10", "tunnel_keepalive": { "enabled": false, "enable_keepalive_ack": true, "keepalive_interval": 10, "dead_time_multiplier": 3 }, "resource_type": "GreTunnel", "id": "aa-gre-1", "display_name": "aa-gre-1", "path": "/infra/tier-0s/Tier0-LR1-AA/locale-services/T0-LR1-LocaleService-1/tunnels/aa-gre-1", "relative_path": "aa-gre-1", "parent_path": "/infra/tier-0s/Tier0-LR1-AA/locale-services/T0-LR1-LocaleService-1", "remote_path": "", "unique_id": "05919494-a00e-4e7b-abb8-daea2f15820d", "realization_id": "05919494-a00e-4e7b-abb8-daea2f15820d", "owner_id": "04e3159d-9c1a-464b-889e-3f52427f1098", "marked_for_delete": false, "overridden": false, "enabled": true, "tunnel_address": [ { "edge_path": "/infra/sites/default/enforcement-points/default/edge-clusters/172c9d22-5257-4e9c-af85-4a652d8f2b05/edge-nodes/0", "tunnel_interface_subnet": [ { "ip_addresses": [ "192.168.10.2" ], "prefix_len": 24 } ], "source_address": "40.40.40.1" }, { "edge_path": "/infra/sites/default/enforcement-points/default/edge-clusters/172c9d22-5257-4e9c-af85-4a652d8f2b05/edge-nodes/1", "tunnel_interface_subnet": [ { "ip_addresses": [ "192.168.20.2" ], "prefix_len": 24 } ], "source_address": "40.40.40.2" } ], "mtu": 1476, "_create_time": 1689587127380, "_create_user": "admin", "_last_modified_time": 1689587127380, "_last_modified_user": "admin", "_system_owned": false, "_protection": "NOT_PROTECTED", "_revision": 0 }, { "destination_address": "44.44.44.11", "tunnel_keepalive": { "enabled": false, "enable_keepalive_ack": true, "keepalive_interval": 10, "dead_time_multiplier": 3 }, "resource_type": "GreTunnel", "id": "aa-gre-10-new", "display_name": "aa-gre-1", "path": "/infra/tier-0s/Tier0-LR1-AA/locale-services/T0-LR1-LocaleService-1/tunnels/aa-gre-10-new", "relative_path": "aa-gre-10-new", "parent_path": "/infra/tier-0s/Tier0-LR1-AA/locale-services/T0-LR1-LocaleService-1", "remote_path": "", "unique_id": "d22a618d-d8c0-4be0-a2b4-94e9485d1f25", "realization_id": "d22a618d-d8c0-4be0-a2b4-94e9485d1f25", "owner_id": "04e3159d-9c1a-464b-889e-3f52427f1098", "marked_for_delete": false, "overridden": false, "enabled": true, "tunnel_address": [ { "edge_path": "/infra/sites/default/enforcement-points/default/edge-clusters/172c9d22-5257-4e9c-af85-4a652d8f2b05/edge-nodes/0", "tunnel_interface_subnet": [ { "ip_addresses": [ "192.168.30.2" ], "prefix_len": 24 } ], "source_address": "40.40.40.1" }, { "edge_path": "/infra/sites/default/enforcement-points/default/edge-clusters/172c9d22-5257-4e9c-af85-4a652d8f2b05/edge-nodes/1", "tunnel_interface_subnet": [ { "ip_addresses": [ "192.168.40.2" ], "prefix_len": 24 } ], "source_address": "40.40.40.2" } ], "mtu": 1476, "_create_time": 1689828248560, "_create_user": "admin", "_last_modified_time": 1689828248560, "_last_modified_user": "admin", "_system_owned": false, "_protection": "NOT_PROTECTED", "_revision": 0 }, { "destination_address": "44.44.44.12", "tunnel_keepalive": { "enabled": false, "enable_keepalive_ack": true, "keepalive_interval": 10, "dead_time_multiplier": 3 }, "resource_type": "GreTunnel", "id": "aa-gre-10-new-1", "display_name": "aa-gre-10-new-1-display-name", "path": "/infra/tier-0s/Tier0-LR1-AA/locale-services/T0-LR1-LocaleService-1/tunnels/aa-gre-10-new-1", "relative_path": "aa-gre-10-new-1", "parent_path": "/infra/tier-0s/Tier0-LR1-AA/locale-services/T0-LR1-LocaleService-1", "remote_path": "", "unique_id": "e8eca44c-965d-4f7e-8886-38304ca5be47", "realization_id": "e8eca44c-965d-4f7e-8886-38304ca5be47", "owner_id": "04e3159d-9c1a-464b-889e-3f52427f1098", "marked_for_delete": false, "overridden": false, "enabled": true, "tunnel_address": [ { "edge_path": "/infra/sites/default/enforcement-points/default/edge-clusters/172c9d22-5257-4e9c-af85-4a652d8f2b05/edge-nodes/0", "tunnel_interface_subnet": [ { "ip_addresses": [ "192.168.50.2" ], "prefix_len": 24 } ], "source_address": "40.40.40.1" }, { "edge_path": "/infra/sites/default/enforcement-points/default/edge-clusters/172c9d22-5257-4e9c-af85-4a652d8f2b05/edge-nodes/1", "tunnel_interface_subnet": [ { "ip_addresses": [ "192.168.60.2" ], "prefix_len": 24 } ], "source_address": "40.40.40.2" } ], "mtu": 1476, "_create_time": 1689828527066, "_create_user": "admin", "_last_modified_time": 1689828527066, "_last_modified_user": "admin", "_system_owned": false, "_protection": "NOT_PROTECTED", "_revision": 0 } ], "result_count": 3, "sort_by": "display_name", "sort_ascending": true }

Required Permissions:

read

Feature:

policy_t0

Additional Errors: