NSX-T Data Center Global Manager REST API

Associated URIs:

API Description API Path

List Tier-1 instances


Paginated list of all Tier-1 instances
GET /global-manager/api/v1/global-infra/tier-1s

Delete Tier-1 configuration


Delete Tier-1 configuration
DELETE /global-manager/api/v1/global-infra/tier-1s/{tier-1-id}

Read Tier-1 configuration


Read Tier-1 configuration
GET /global-manager/api/v1/global-infra/tier-1s/{tier-1-id}

Create or update Tier-1 configuration


If Tier-1 with the tier-1-id is not already present, create a new Tier-1 instance.
If it already exists, update the tier-1 instance with specified attributes.
PATCH /global-manager/api/v1/global-infra/tier-1s/{tier-1-id}

Create or update tier-1 configuration


If Tier-1 with the tier-1-id is not already present, create a new Tier-1 instance.
If it already exists, replace the Tier-1 instance with this object.
PUT /global-manager/api/v1/global-infra/tier-1s/{tier-1-id}

List advertised networks


Return networks which are advertised to connected TIER0 gateway.
GET /global-manager/api/v1/global-infra/tier-1s/{tier-1-id}/advertised-networks

List advertised networks in CSV format


Return networks which are advertised to connected TIER0 gateway in CSV format.
GET /global-manager/api/v1/global-infra/tier-1s/{tier-1-id}/advertised-networks/csv

Get Tier-1 Address Resolution Protocol Proxies in CSV format


Returns ARP proxy table for a tier-1 in CSV format
GET /global-manager/api/v1/global-infra/tier-1s/{tier-1-id}/arp-proxies?format=csv

Get Tier-1 Address Resolution Protocol Proxies


Returns ARP proxy table for a tier-1
GET /global-manager/api/v1/global-infra/tier-1s/{tier-1-id}/arp-proxies

Get forwarding table from tier-1 in CSV format


Get forwarding table from tier-1 gateway in CSV format.
GET /global-manager/api/v1/global-infra/tier-1s/{tier-1-id}/forwarding-table?format=csv

Get forwarding table from tier-1


Get forwarding table from tier-1
GET /global-manager/api/v1/global-infra/tier-1s/{tier-1-id}/forwarding-table

List Tier-1 locale-services


Paginated list of all Tier-1 locale-services
GET /global-manager/api/v1/global-infra/tier-1s/{tier-1-id}/locale-services

Get Tier-1 Address Resolution Protocol Proxies


Get Tier-1 Address Resolution Protocol Proxies.
GET /global-manager/api/v1/global-infra/tier-1s/{tier-1-id}/locale-services/{locale-service-id}/arp-proxies (Deprecated)

List Tier-1 Interface groups


Paginated list of all Tier-1 Interface groups under locale service.
GET /global-manager/api/v1/global-infra/tier-1s/{tier-1-id}/locale-services/{locale-service-id}/interface-groups

Delete Tier-1 Interface group


Delete Tier-1 Interface group
DELETE /global-manager/api/v1/global-infra/tier-1s/{tier-1-id}/locale-services/{locale-service-id}/interface-groups/{group-id}

Read Tier-1 Interface group


Read Tier-1 Interface group
GET /global-manager/api/v1/global-infra/tier-1s/{tier-1-id}/locale-services/{locale-service-id}/interface-groups/{group-id}

Create or update a Tier-1 Interface group.


If an Interface group with the label-id is not already present, create a new
Interface group. If it already exists, update the Interface group for specified attributes.
PATCH /global-manager/api/v1/global-infra/tier-1s/{tier-1-id}/locale-services/{locale-service-id}/interface-groups/{group-id}

Update a Tier-1 Interface group.


Update the Interface group for specified attributes.
PUT /global-manager/api/v1/global-infra/tier-1s/{tier-1-id}/locale-services/{locale-service-id}/interface-groups/{group-id}

Get tier-1 interface group statistics information


Get tier-1 interface group statistics information.
GET /global-manager/api/v1/global-infra/tier-1s/{tier-1-id}/locale-services/{locale-service-id}/interface-groups/{interface-group-id}/statistics

Get Tier-1 Interface Address Resolution Protocol Proxies in CSV format


Returns ARP proxy table for a tier-1 interface in CSV format
GET /global-manager/api/v1/global-infra/tier-1s/{tier-1-id}/locale-services/{locale-service-id}/interfaces/{interface-id}/arp-proxy?format=csv

Get Tier-1 Interface Address Resolution Protocol Proxies


Returns ARP proxy table for a tier-1 interface
GET /global-manager/api/v1/global-infra/tier-1s/{tier-1-id}/locale-services/{locale-service-id}/interfaces/{interface-id}/arp-proxy

Get ARP table from tier-1 interface


Returns ARP table (IPv4) or Neighbor Discovery table (IPv6) for the
tier-1 interface, on a edge node specified in edge_path parameter.
The edge_path parameter is mandatory.
GET /global-manager/api/v1/global-infra/tier-1s/{tier-1-id}/locale-services/{locale-service-id}/interfaces/{interface-id}/arp-table

Get ARP table from tier-1 interface in CSV format


Returns ARP table (IPv4) or Neighbor Discovery table (IPv6) in CSV format
for the tier-1 interface, on a edge node specified in edge_path parameter.
The edge_path parameter is mandatory.
GET /global-manager/api/v1/global-infra/tier-1s/{tier-1-id}/locale-services/{locale-service-id}/interfaces/{interface-id}/arp-table?format=csv

Get tier-1 interface statistics information


Get tier-1 interface statistics information.
GET /global-manager/api/v1/global-infra/tier-1s/{tier-1-id}/locale-services/{locale-service-id}/interfaces/{interface-id}/statistics

Get tier-1 interface statistics summary information


Get tier-1 interface statistics summary information.
GET /global-manager/api/v1/global-infra/tier-1s/{tier-1-id}/locale-services/{locale-service-id}/interfaces/{interface-id}/statistics/summary

List Tier 1 Service Interfaces


Paginated list of all Tier 1 Service Interfaces
GET /global-manager/api/v1/global-infra/tier-1s/{tier-1-id}/locale-services/{locale-service-id}/service-interfaces

Delete Tier 1 service interface


Delete Tier 1 service interface
DELETE /global-manager/api/v1/global-infra/tier-1s/{tier-1-id}/locale-services/{locale-service-id}/service-interfaces/{interface-id}

Read Tier 1 service interface


Read Tier 1 service interface
GET /global-manager/api/v1/global-infra/tier-1s/{tier-1-id}/locale-services/{locale-service-id}/service-interfaces/{interface-id}

Create or update a Tier-1 service interface


If a Tier1 service interface with the interface-id is not already present, create a new Tier1 service
interface.
PATCH /global-manager/api/v1/global-infra/tier-1s/{tier-1-id}/locale-services/{locale-service-id}/service-interfaces/{interface-id}

Create a Tier1 service interface


If a Tier1 service interface with the interface-id is not already present, create a new Tier1 service
interface. Modification of Tier 1 service interface is not allowed.
PUT /global-manager/api/v1/global-infra/tier-1s/{tier-1-id}/locale-services/{locale-service-id}/service-interfaces/{interface-id}

Delete Tier-1 locale-services


Delete Tier-1 locale-services
DELETE /global-manager/api/v1/global-infra/tier-1s/{tier-1-id}/locale-services/{locale-services-id}

Read Tier-1 locale-services


Read Tier-1 locale-services
GET /global-manager/api/v1/global-infra/tier-1s/{tier-1-id}/locale-services/{locale-services-id}

Create or update a Tier-1 locale-services


If a Tier-1 locale services with the locale-services-id is not already
present, create a new locale services. If it already exists, update
Tier-1 locale services with specified attributes.
PATCH /global-manager/api/v1/global-infra/tier-1s/{tier-1-id}/locale-services/{locale-services-id}

Create or update a Tier-1 locale-services


If a Tier-1 locale services with the locale-services-id is not already
present, create a new locale-services. If it already exists, replace the
Tier-1 locale services instance with the new object.

Modifying edge cluster re-allocates NSX service routers of TIER1 to a different edge
cluster. You can also place edge nodes manually and provide maximum two indices
for HA mode ACTIVE_STANDBY. To re-allocating edge cluster is a disruptive operation
and all existing statistics of Tier1 gateway will be removed.
PUT /global-manager/api/v1/global-infra/tier-1s/{tier-1-id}/locale-services/{locale-services-id}

List Tier-1 interfaces


Paginated list of all Tier-1 interfaces
GET /global-manager/api/v1/global-infra/tier-1s/{tier-1-id}/locale-services/{locale-services-id}/interfaces

Delete Tier-1 interface


Delete Tier-1 interface
DELETE /global-manager/api/v1/global-infra/tier-1s/{tier-1-id}/locale-services/{locale-services-id}/interfaces/{interface-id}

Read Tier-1 interface


Read Tier-1 interface
GET /global-manager/api/v1/global-infra/tier-1s/{tier-1-id}/locale-services/{locale-services-id}/interfaces/{interface-id}

Create or update a Tier-1 interface


If an interface with the interface-id is not already present, create a new
interface. If it already exists, update the interface for specified
attributes.
PATCH /global-manager/api/v1/global-infra/tier-1s/{tier-1-id}/locale-services/{locale-services-id}/interfaces/{interface-id}

Create or update a tier-1 interface


If an interface with the interface-id is not already present, create a new
interface. If it already exists, replace the interface with this object.
PUT /global-manager/api/v1/global-infra/tier-1s/{tier-1-id}/locale-services/{locale-services-id}/interfaces/{interface-id}

Get ARP table from segment interface (downlink)


Returns ARP table (IPv4) or Neighbor Discovery table (IPv6) for the
interface (downlink) attaching segment to tier-1 gateway, on a edge
node specified in edge_path parameter.
The edge_path parameter is mandatory.
GET /global-manager/api/v1/global-infra/tier-1s/{tier-1-id}/segments/{segment-id}/arp-table

Get ARP table from segment interface (downlink) in CSV format


Returns ARP table (IPv4) or Neighbor Discovery table (IPv6) in CSV format for the
interface (downlink) attaching segment to tier1 gateway, on a edge
node specified in edge_path parameter.
The edge_path parameter is mandatory.
GET /global-manager/api/v1/global-infra/tier-1s/{tier-1-id}/segments/{segment-id}/arp-table?format=csv

Get ARP table for downlink router port on tier-1 router


Get ARP table for downlink router port on tier-1 router.
GET /global-manager/api/v1/global-infra/tier-1s/{tier-1-id}/segments/{segment-id}/gateway-interface-arp-table (Deprecated)

Get ARP table for downlink router port on tier-1 router in CSV


Get ARP table for downlink router port on tier-1 router in CSV.
GET /global-manager/api/v1/global-infra/tier-1s/{tier-1-id}/segments/{segment-id}/gateway-interface-arp-table?format=csv (Deprecated)

Get DAD state for downlink router port on tier-1 router


Segment ID is the ID of the segment that is connected to the the tier-1
GET /global-manager/api/v1/global-infra/tier-1s/{tier-1-id}/segments/{segment-id}/gateway-interface-dad-state

Get statistics for downlink router port on tier-1 router


Segment ID is the ID of the segment that is connected to the the tier-1
GET /global-manager/api/v1/global-infra/tier-1s/{tier-1-id}/segments/{segment-id}/gateway-interface-statistics

Get statistics for downlink router port on tier-1 router


Segment ID is the ID of the segment that is connected to the the tier-1
GET /global-manager/api/v1/global-infra/tier-1s/{tier-1-id}/segments/{segment-id}/gateway-interface-statistics/summary

Get Tier1 state


Returns
GET /global-manager/api/v1/global-infra/tier-1s/{tier-1-id}/state

List Tier-1 Static Routes


Paginated list of all Tier-1 Static Routes
GET /global-manager/api/v1/global-infra/tier-1s/{tier-1-id}/static-routes

Delete Tier-1 static routes


Delete Tier-1 static routes
DELETE /global-manager/api/v1/global-infra/tier-1s/{tier-1-id}/static-routes/{route-id}

Read Tier-1 static routes


Read Tier-1 static routes
GET /global-manager/api/v1/global-infra/tier-1s/{tier-1-id}/static-routes/{route-id}

Create or update a Tier-1 static routes


If static routes for route-id are not already present, create
static routes. If it already exists, update static routes for route-id.
PATCH /global-manager/api/v1/global-infra/tier-1s/{tier-1-id}/static-routes/{route-id}

Create or update a Tier-1 static routes


If static routes for route-id are not already present, create
static routes. If it already exists, replace the static routes for route-id.
PUT /global-manager/api/v1/global-infra/tier-1s/{tier-1-id}/static-routes/{route-id}

Get ARP table from tier-1 router link interface in CSV format


Returns ARP table (IPv4) or Neighbor Discovery table (IPv6) in CSV format
for the tier-1 router link interface.
GET /global-manager/api/v1/global-infra/tier-1s/{tier-1-id}/tier-0-interface/arp-table?format=csv

Get tier-1 router link arp information


Get tier-1 interface arp information.
GET /global-manager/api/v1/global-infra/tier-1s/{tier-1-id}/tier-0-interface/arp-table

Get tier-1 router link statistics information


Get tier-1 router link statistics information for the linked tier-0 interface.
GET /global-manager/api/v1/global-infra/tier-1s/{tier-1-id}/tier-0-interface/statistics

Get tier-1 router link statistics summary information


Get tier-1 router link statistics summary information.
GET /global-manager/api/v1/global-infra/tier-1s/{tier-1-id}/tier-0-interface/statistics/summary