NSX-T Data Center Global Manager REST API

Deprecated Methods

The following API methods are deprecated in this version. Deprecated methods continue to function, but may be removed in a future NSX version. Each deprecated method's documentation will advise what new method should be called instead of the deprecated method.

API Description API Path
Federation > Inter-Sites (Legacy Management Plane)
Get infra segment cross site traffic statistics

Deprecated: This API is deprecated. Please use GET /infra/segments//inter-site-forwarder/stats instead. 		GET /global-manager/api/v1/global-infra/segments/{segment-id}/inter-site-forwarder/status (Deprecated)
Federation > Inter-Sites (Legacy Management Plane)
Get RTEP span and mac address-table

Deprecated: This API is deprecated. Please use GET /infra/sites//enforcement-points//edge-clusters//remote-tep-connectivity/bgp/summary instead. 		GET /global-manager/api/v1/global-infra/tier-0s/{tier-0-id}/locale-services/{locale-services-id}/inter-site/bgp-summary (Deprecated)
Federation > Inter-Sites (Legacy Management Plane)
Get RTEP mesh connectivity status

Deprecated: This API is deprecated. Please use GET /infra/sites//enforcement-points//edge-clusters//remote-tep-connectivity/status instead. 		GET /global-manager/api/v1/global-infra/tier-0s/{tier-0-id}/locale-services/{locale-services-id}/inter-site/status (Deprecated)
Federation > Inter-Sites (Legacy Management Plane)
Get segment cross site traffic statistics

Deprecated: This API is deprecated. Please use GET /infra/tier-1s//segments//inter-site-forwarder/stats instead. 		GET /global-manager/api/v1/global-infra/tier-1s/{tier-1-id}/segments/{segment-id}/inter-site-forwarder/status (Deprecated)
Inventory > Context Profiles
Update custom object attribute value list for given attribute key

Deprecated: This rest routine is deprecated. Use /infra/context-profiles/custom-attributes/default for create/update custom object attribute value list for given attribute key 		PATCH /global-manager/api/v1/global-infra/context-profiles/custom-attributes (Deprecated)
Inventory > Context Profiles
Adds/Removes custom attribute values from list

Deprecated: This rest routine is deprecated. Use /infra/context-profiles/custom-attributes/default to Adds/Removes custom attribute values from list 		POST /global-manager/api/v1/global-infra/context-profiles/custom-attributes (Deprecated)
Inventory > Group Members
Get logical ports that belong to this Group

Deprecated: This rest routine is deprecated. Use /infra/domains/<domain-id>/groups/<group-id>/members/segment-ports instead for effective segment-port members as LogicalPort is not a supported member type . 		GET /global-manager/api/v1/global-infra/domains/{domain-id}/groups/{group-id}/members/logical-ports (Deprecated)
Inventory > Group Members
Get logical switches that belong to this Group

Deprecated: This rest routine is deprecated. Use /infra/domains/<domain-id>/groups/<group-id>/members/segments instead for effective segment members as LogicalSwitch is not a supported member type. 		GET /global-manager/api/v1/global-infra/domains/{domain-id}/groups/{group-id}/members/logical-switches (Deprecated)
Monitoring > Dashboard (Legacy Management Plane)
Returns the Views based on query criteria defined in ViewQueryParameters.

Deprecated: This API is deprecated and will be unavailable in later releases.		 GET /global-manager/api/v1/ui-views (Deprecated)
Monitoring > Dashboard (Legacy Management Plane)
Creates a new View.

Deprecated: This API is deprecated and will be unavailable in later releases.		 POST /global-manager/api/v1/ui-views (Deprecated)
Monitoring > Dashboard (Legacy Management Plane)
Delete View

Deprecated: This API is deprecated and will be unavailable in later releases.		 DELETE /global-manager/api/v1/ui-views/{view-id} (Deprecated)
Monitoring > Dashboard (Legacy Management Plane)
Returns View Information

Deprecated: This API is deprecated and will be unavailable in later releases.		 GET /global-manager/api/v1/ui-views/{view-id} (Deprecated)
Monitoring > Dashboard (Legacy Management Plane)
Update View

Deprecated: This API is deprecated and will be unavailable in later releases.		 PUT /global-manager/api/v1/ui-views/{view-id} (Deprecated)
Monitoring > Dashboard (Legacy Management Plane)
Returns the Widget Configurations based on query criteria defined in WidgetQueryParameters.

Deprecated: This API is deprecated and will be unavailable in later releases.		 GET /global-manager/api/v1/ui-views/{view-id}/widgetconfigurations (Deprecated)
Monitoring > Dashboard (Legacy Management Plane)
Creates a new Widget Configuration.

Deprecated: This API is deprecated and will be unavailable in later releases.		 POST /global-manager/api/v1/ui-views/{view-id}/widgetconfigurations (Deprecated)
Monitoring > Dashboard (Legacy Management Plane)
Delete Widget Configuration

Deprecated: This API is deprecated and will be unavailable in later releases.		 DELETE /global-manager/api/v1/ui-views/{view-id}/widgetconfigurations/{widgetconfiguration-id} (Deprecated)
Monitoring > Dashboard (Legacy Management Plane)
Returns Widget Configuration Information

Deprecated: This API is deprecated and will be unavailable in later releases.		 GET /global-manager/api/v1/ui-views/{view-id}/widgetconfigurations/{widgetconfiguration-id} (Deprecated)
Monitoring > Dashboard (Legacy Management Plane)
Update Widget Configuration

Deprecated: This API is deprecated and will be unavailable in later releases.		 PUT /global-manager/api/v1/ui-views/{view-id}/widgetconfigurations/{widgetconfiguration-id} (Deprecated)
Networking (Routing) > Tier-0S (Arp Proxies)
Get Tier-0 Address Resolution Protocol Proxies

Deprecated: This API is deprecated. Please use /infra/tier-0s/<tier-0-id>/arp-proxies 		GET /global-manager/api/v1/global-infra/tier-0s/{tier-0-id}/locale-services/{locale-service-id}/arp-proxies (Deprecated)
Networking (Routing) > Tier-0S (Arp Tables)
Get ARP table for downlink router port on tier-0 router

Deprecated: This API is deprecated because it is duplicate. Please use /infra/segments/<segment-id>/arp-table Segment ID is the ID of the segment that is connected to the the tier-0 		GET /global-manager/api/v1/global-infra/segments/{segment-id}/gateway-interface-arp-table (Deprecated)
Networking (Routing) > Tier-0S (Arp Tables)
Get ARP table for downlink router port on tier-0 router in CSV

Deprecated: This API is deprecated because it is duplicate. Please use /infra/segments/<segment-id>/arp-table?format=csv Segment ID is the ID of the segment that is connected to the the tier-0 		GET /global-manager/api/v1/global-infra/segments/{segment-id}/gateway-interface-arp-table?format=csv (Deprecated)
Networking (Routing) > Tier-1S (Arp Proxies)
Get Tier-1 Address Resolution Protocol Proxies

Deprecated: This API is deprecated. Please use /infra/tier-1s/<tier-1-id>/arp-proxies Returns ARP proxy table for a tier-1 		GET /global-manager/api/v1/global-infra/tier-1s/{tier-1-id}/locale-services/{locale-service-id}/arp-proxies (Deprecated)
Networking (Routing) > Tier-1S (Arp Tables)
Get ARP table for downlink router port on tier-1 router

Deprecated: This API is deprecated because it is duplicate. Please use /infra/tier-1s/<tier-1-id>/segments/<segment-id>/arp-table 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-arp-table (Deprecated)
Networking (Routing) > Tier-1S (Arp Tables)
Get ARP table for downlink router port on tier-1 router in CSV

Deprecated: This API is deprecated because it is duplicate. Please use /infra/tier-1s/<tier-1-id>/segments/<segment-id>/arp-table?format=csv 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-arp-table?format=csv (Deprecated)
Security (East West) > Distributed Firewall (Identity Firewall)
Invoke full sync or delta sync for a specific domain, with additional delay in seconds if needed. Stop sync will try to stop any pending sync if any to return to idle state.

Deprecated:
Use the following Policy API -
POST /infra/identity-firewall-stores/action/delta-sync; POST /infra/identity-firewall-stores/action/full-sync; POST /infra/identity-firewall-stores/action/stop-sync;		 POST /global-manager/api/v1/global-infra/firewall-identity-stores/{firewall-identity-store-id} (Deprecated)
Security (East West) > Distributed Firewall (Identity Firewall)
Test a LDAP server connection for directory domain

Deprecated:
Use the following Policy API -
POST /infra/identity-firewall-stores/ldap-servers/action/connectivity-check		 POST /global-manager/api/v1/global-infra/firewall-identity-stores/{firewall-identity-store-id}/ldap-servers/{ldap-server-id} (Deprecated)
Security (North South) > Gateway Firewall (Settings)
Delete security config

Deprecated: Use the following API PUT/PATCH /infra/tier-0s//security-config 		DELETE /global-manager/api/v1/global-infra/tier-0s/{tier-0-id}/security-config (Deprecated)
System (Administration) > API Services
Register a Collection of API Calls at a Single End Point

Deprecated: Support for batched operations will be removed from a future NSX release. For policy APIs, use the hierarchical API to submit a set of updates as a single operation. For other APIs, submit the operations as individual REST API calls.		 POST /global-manager/api/v1/batch (Deprecated)
System (Administration) > Certificates
Set a certificate as a GM or LM Principal Identity certificate

Deprecated:
Please use below APIs.
POST https://<nsx-mgr>/api/v1/trust-management/certificates/<cert-id>?action=apply_certificate&service_type=LOCAL_MANAGER
POST https://<nsx-mgr>/api/v1/trust-management/certificates/<cert-id>?action=apply_certificate&service_type=GLOBAL_MANAGER		 POST /api/v1/trust-management/certificates?action=set_pi_certificate_for_federation (Deprecated)
System (Administration) > Certificates
Set a certificate as the Appliance Proxy certificate to be used in inter-site communication

Deprecated:
Please use below APIs.
POST https://<nsx-mgr>/api/v1/trust-management/certificates/<cert-id>?action=apply_certificate&service_type=APH		 POST /api/v1/trust-management/certificates?action=set_appliance_proxy_certificate_for_inter_site_communication (Deprecated)
System (Administration) > Certificates
Return the list of CrlDistributionPoints

Deprecated: Do not use. This is currently unused functionality that will be removed.		 GET /api/v1/trust-management/crl-distribution-points (Deprecated)
System (Administration) > Certificates
Create a Crl Distribution Point

Deprecated: Do not use. This is currently unused functionality that will be removed.		 POST /api/v1/trust-management/crl-distribution-points (Deprecated)
System (Administration) > Certificates
Delete a CrlDistributionPoint

Deprecated: Do not use. This is currently unused functionality that will be removed.		 DELETE /api/v1/trust-management/crl-distribution-points/{crl-distribution-point-id} (Deprecated)
System (Administration) > Certificates
Return the CrlDistributionPoint with <crl-distribution-point-id>

Deprecated: Do not use. This is currently unused functionality that will be removed.		 GET /api/v1/trust-management/crl-distribution-points/{crl-distribution-point-id} (Deprecated)
System (Administration) > Certificates
Return the status of the CrlDistributionPoint

Deprecated: Do not use. This is currently unused functionality that will be removed.		 GET /api/v1/trust-management/crl-distribution-points/{crl-distribution-point-id}/status (Deprecated)
System (Administration) > Certificates
Return stored CRL in PEM format

Deprecated: Do not use. This is currently unused functionality that will be removed.		 POST /api/v1/trust-management/crl-distribution-points/pem-file (Deprecated)
System (Administration) > Certificates
Generate a New Certificate Signing Request with Extensions

Deprecated: Deprecated in favor of POST /trust-management/csrs. 		POST /api/v1/trust-management/csrs-extended (Deprecated)
System (Administration) > NSX Manager (Cluster Certificate)
 POST /api/v1/cluster/api-certificate?action=clear_cluster_certificate (Deprecated)
System (Administration) > NSX Manager (Cluster Certificate)
Set the cluster certificate

Deprecated: Please use below APIs.
POST https://<nsx-mgr>/api/v1/trust-management/certificates/?action=apply_certificate&service_type=MGMT_CLUSTER		 POST /api/v1/cluster/api-certificate?action=set_cluster_certificate (Deprecated)
System (Administration) > NSX Manager (Http Service)
Update http service certificate

Deprecated: Please use below APIs.
POST https://<nsx-mgr>/api/v1/trust-management/certificates/?action=apply_certificate&service_type=API&node_id=		 POST /api/v1/cluster/{cluster-node-id}/node/services/http?action=apply_certificate (Deprecated)
POST /api/v1/node/services/http?action=apply_certificate (Deprecated)
System (Administration) > NSX Manager (Telemetry Service)
Read Telemetry service properties

Deprecated: This API is deprecated. Use:
GET https://<nsx-mgr>/api/v1/node/services/monitoring		 GET /api/v1/cluster/{cluster-node-id}/node/services/telemetry (Deprecated)
GET /api/v1/node/services/telemetry (Deprecated)
System (Administration) > NSX Manager (Telemetry Service)
Reset the logging levels to default values

Deprecated: This API is deprecated. Use:
POST https://<nsx-mgr>/api/v1/node/services/monitoring?action=reset-monitoring-logging-levels		 POST /api/v1/cluster/{cluster-node-id}/node/services/telemetry?action=reset-telemetry-logging-levels (Deprecated)
POST /api/v1/node/services/telemetry?action=reset-telemetry-logging-levels (Deprecated)
System (Administration) > NSX Manager (Telemetry Service)
Restart, start or stop Telemetry service

Deprecated: This API is deprecated. Use:
POST https://<nsx-mgr>/api/v1/node/services/monitoring?action=restart|start|stop		 POST /api/v1/cluster/{cluster-node-id}/node/services/telemetry?action=restart (Deprecated)
POST /api/v1/cluster/{cluster-node-id}/node/services/telemetry?action=start (Deprecated)
POST /api/v1/cluster/{cluster-node-id}/node/services/telemetry?action=stop (Deprecated)
POST /api/v1/node/services/telemetry?action=restart (Deprecated)
POST /api/v1/node/services/telemetry?action=start (Deprecated)
POST /api/v1/node/services/telemetry?action=stop (Deprecated)
System (Administration) > NSX Manager (Telemetry Service)
Update Telemetry service properties

Deprecated: This API is deprecated. Use:
PUT https://<nsx-mgr>/api/v1/node/services/monitoring		 PUT /api/v1/cluster/{cluster-node-id}/node/services/telemetry (Deprecated)
PUT /api/v1/node/services/telemetry (Deprecated)
System (Administration) > NSX Manager (Telemetry Service)
Read Telemetry service status

Deprecated: This API is deprecated. Use:
GET https://<nsx-mgr>/api/v1/node/services/monitoring/status		 GET /api/v1/cluster/{cluster-node-id}/node/services/telemetry/status (Deprecated)
GET /api/v1/node/services/telemetry/status (Deprecated)
System (Fabric) > Compute Managers
Return thumbprint hashing algorithm config used for compute manager extension

Deprecated: Deprecated from 9.1.1 - SHA256 is mandatory and SHA1 is no longer supported. 		GET /api/v1/fabric/compute-managers/thumbprint-hashing-algorithm (Deprecated)
System (Fabric) > Compute Managers
Update thumbprint hashing algorithm used for compute manager extension

Deprecated: Deprecated from 9.1.1 - SHA256 is mandatory and SHA1 is no longer supported. 		PUT /api/v1/fabric/compute-managers/thumbprint-hashing-algorithm (Deprecated)
System (Lifecycle Management) > Upgrade (Bundles)
 POST /api/v1/upgrade/bundle?action=upload (Deprecated)
System (Lifecycle Management) > Upgrade (Nodes)
 GET /api/v1/cluster/{cluster-node-id}/node/upgrade (Deprecated)
GET /api/v1/node/upgrade (Deprecated)
System (Lifecycle Management) > Upgrade (Plan)
Start upgrade

Deprecated:
This rest routine is deprecated. Use /upgrade/plan?action=upgrade to start, retry or continue the upgrade.		 POST /api/v1/upgrade/plan?action=start (Deprecated)
System (Lifecycle Management) > Upgrade (Plan)
Continue upgrade

Deprecated:
This rest routine is deprecated. Use /upgrade/plan?action=upgrade to start, retry or continue the upgrade.		 POST /api/v1/upgrade/plan?action=continue (Deprecated)
Troubleshooting > Traceflow
Create or update a traceflow config

Deprecated: Please use PUT API to start new Traceflow sessions. By default, traceflow observations will be cleanup every two hours, please use is_transient flag to avoid the cleanup. 		PATCH /global-manager/api/v1/global-infra/traceflows/{traceflow-id} (Deprecated)
Troubleshooting > Traceflow
Restart traceflow with same set of parameters used during create/update traceflow

Deprecated: Please use PUT API to start new Traceflow sessions. By default, traceflow observations will be cleanup every two hours, please use is_transient flag to avoid the cleanup. 		POST /global-manager/api/v1/global-infra/traceflows/{traceflow-id} (Deprecated)
User Management > Access Token
Delete registration access token

Deprecated: Use API POST /api/v1/aaa/registration-token/delete		 DELETE /global-manager/api/v1/aaa/registration-token/{token} (Deprecated)
DELETE /api/v1/aaa/registration-token/{token} (Deprecated)
User Management > Access Token
Get registration access token

Deprecated: Use API POST /api/v1/aaa/registration-token/retrieve		 GET /global-manager/api/v1/aaa/registration-token/{token} (Deprecated)
GET /api/v1/aaa/registration-token/{token} (Deprecated)
User Management > Principal Identities
Register a name-certificate combination.

Deprecated: Deprecated, use POST /trust-management/principal-identities/with-certificate instead. 		POST /api/v1/trust-management/principal-identities (Deprecated)
User Management > VIDM Configuration
Get all the User Groups where vIDM display name matches the search key case insensitively. The search key is checked to be a substring of display name. This is a non paginated API. This API will return as many results that vIDM returns to NSX during the search query. vIDM may not send all results at once so to zero in on the group of interest more characters need to be entered.

Deprecated: vIDM is deprecated by vIDB. Use API POST /api/v1/trust-management/oidc-uris/{id}/search.		 GET /global-manager/api/v1/aaa/vidm/groups (Deprecated)
GET /api/v1/aaa/vidm/groups (Deprecated)
User Management > VIDM Configuration
Get all the users and groups from vIDM matching the search key case insensitively. The search key is checked to be a substring of name or given name or family name of user and display name of group. This is a non paginated API. This API will return as many results that vIDM returns to NSX during the search query. vIDM may not send all results at once so to zero in on the user/group of interest more characters need to be entered.

Deprecated: vIDM is deprecated by vIDB. Use API POST /api/v1/trust-management/oidc-uris/{id}/search.		 POST /global-manager/api/v1/aaa/vidm/search (Deprecated)
POST /api/v1/aaa/vidm/search (Deprecated)
User Management > VIDM Configuration
Get all the users from vIDM whose userName, givenName or familyName matches the search key case insensitively. The search key is checked to be a substring of name or given name or family name. This is a non paginated API. This API will return as many results that vIDM returns to NSX during the search query. vIDM may not send all results at once so to zero in on the user of interest more characters need to be entered.

Deprecated: vIDM is deprecated by vIDB. Use API POST /api/v1/trust-management/oidc-uris/{id}/search.		 GET /global-manager/api/v1/aaa/vidm/users (Deprecated)
GET /api/v1/aaa/vidm/users (Deprecated)
User Management > VIDM Configuration
Read AAA provider vIDM properties

Deprecated: vIDM is deprecated by vIDB. Use API GET /api/v1/trust-management/oidc-uris/.		 GET /api/v1/cluster/{cluster-node-id}/node/aaa/providers/vidm (Deprecated)
GET /api/v1/node/aaa/providers/vidm (Deprecated)
User Management > VIDM Configuration
Update AAA provider vIDM properties

Deprecated: vIDM is deprecated by vIDB. Use API POST /api/v1/trust-management/oidc-uris/action/configure-vidb-oidc-endpoint.		 PUT /api/v1/cluster/{cluster-node-id}/node/aaa/providers/vidm (Deprecated)
PUT /api/v1/node/aaa/providers/vidm (Deprecated)
User Management > VIDM Configuration
Read AAA provider vIDM status

Deprecated: vIDM is deprecated by vIDB. Use API GET /api/v1/trust-management/oidc-uris/{id}/health.		 GET /api/v1/cluster/{cluster-node-id}/node/aaa/providers/vidm/status (Deprecated)
GET /api/v1/node/aaa/providers/vidm/status (Deprecated)