System Administration

System Administration > Configuration

Associated URIs:

API Description API Path

Register a Collection of API Calls at a Single End Point


Enables you to make multiple API requests using a single request. The batch
API takes in an array of logical HTTP requests represented as JSON arrays.
Each request has a method (GET, PUT, POST, or DELETE), a relative_url (the
portion of the URL after https://<nsx-mgr>/api/), optional headers
array (corresponding to HTTP headers) and an optional body (for POST and PUT
requests). The batch API returns an array of logical HTTP responses
represented as JSON arrays. Each response has a status code, an optional
headers array and an optional body (which is a JSON-encoded string).
POST /api/v1/batch

Read Cluster Configuration


Returns information about the NSX cluster configuration. An NSX cluster has
two functions or purposes, commonly referred to as "roles." These two roles
are control and management. Each NSX installation has a single cluster.
Separate NSX clusters do not share data. In other words, a given data-plane
node is attached to only one cluster, not to multiple clusters.
GET /api/v1/cluster

Join this node to a NSX Cluster


POST /api/v1/cluster?action=join_cluster

List Cluster Profiles


Returns paginated list of cluster profiles
Cluster profiles define policies for edge cluster and bridge cluster.
GET /api/v1/cluster-profiles

Create a Cluster Profile


Create a cluster profile. The resource_type is required.
POST /api/v1/cluster-profiles

Delete a cluster profile


Delete a specified cluster profile.
DELETE /api/v1/cluster-profiles/<cluster-profile-id>

Get cluster profile by Id


Returns information about a specified cluster profile.
GET /api/v1/cluster-profiles/<cluster-profile-id>

Update a cluster profile


Modifie a specified cluster profile. The body of the PUT request must
include the resource_type.
PUT /api/v1/cluster-profiles/<cluster-profile-id>

Read cluster node configuration


Returns information about the specified NSX cluster node.
GET /api/v1/cluster/<node-id>

Detach a node from the Cluster


POST /api/v1/cluster/<node-id>?action=remove_node

Invoke DELETE request on target cluster node


DELETE /api/v1/cluster/<target-node-id>/<target-uri>

Invoke GET request on target cluster node


GET /api/v1/cluster/<target-node-id>/<target-uri>

Invoke POST request on target cluster node


POST /api/v1/cluster/<target-node-id>/<target-uri>

Invoke PUT request on target cluster node


PUT /api/v1/cluster/<target-node-id>/<target-uri>

Read cluster certificate ID


Returns the ID of the certificate that is used as the cluster certificate for MP
GET /api/v1/cluster/api-certificate

Clear the cluster certificate


Clears the certificate used for the MP cluster.
This does not affect the certificate itself.
This API is deprecated. Instead use the
/api/v1/cluster/api-certificate?action=set_cluster_certificate API to set
the cluster certificate to a different one.
It just means that from now on, individual certificates will be used on
each MP node. This affects all nodes in the cluster.
POST /api/v1/cluster/api-certificate?action=clear_cluster_certificate (Deprecated)

Set the cluster certificate


Sets the certificate used for the MP cluster.
This affects all nodes in the cluster. If the certificate used is a CA signed
certificate,the request fails if the whole chain(leaf, intermediate, root)
is not imported.
POST /api/v1/cluster/api-certificate?action=set_cluster_certificate

Read API service properties


Read the configuration of the NSX API service.
GET /api/v1/cluster/api-service

Update API service properties


Read the configuration of the NSX API service. Changes are applied to all nodes in the cluster. The API service on each node will restart after it is updated using this API. There may be a delay of up to a minute or so between the time this API call completes and when the new configuration goes into effect.
PUT /api/v1/cluster/api-service

Read cluster virtual IP address


Returns the configured cluster virtual IP address or null if not configured.
GET /api/v1/cluster/api-virtual-ip

Clear cluster virtual IP address


Clears the cluster virtual IP address.
POST /api/v1/cluster/api-virtual-ip?action=clear_virtual_ip

Set cluster virtual IP address


Sets the cluster virtual IP address. Note, all nodes in the management
cluster must be in the same subnet. If not, a 409 CONFLICT status is
returned.
POST /api/v1/cluster/api-virtual-ip?action=set_virtual_ip

Get backup frames for UI


Returns list of backup frames and some metadata to be used by UI.
GET /api/v1/cluster/backups/ui_frames

Synchronizes the repository data between nsx managers.


Attempts to synchronize the repository partition on nsx manager. Repository partition contains packages required for the
install and upgrade of nsx components.Normally there is no need to call this API explicitely by the user.
POST /api/v1/cluster/node?action=repo_sync

List Cluster Node Configurations


Returns information about all NSX cluster nodes.
GET /api/v1/cluster/nodes

Add a controller to the cluster


Add a new controller to the NSX cluster.
Deprecated. Use POST /cluster?action=join_cluster to join a node to cluster.
The controller comes with the new node.
POST /api/v1/cluster/nodes (Deprecated)

Remove a controller from the cluster


Removes the specified controller from the NSX cluster. Before you can
remove a controller from the cluster, you must shut down the controller
service with the "stop service controller" command.
Deprecated. Use POST /cluster/?action=remove_node
to detach a node from cluster. The controller is removed with the node.
DELETE /api/v1/cluster/nodes/<node-id> (Deprecated)

Read Cluster Node Configuration


Returns information about the specified NSX cluster node.
Deprecated. Use GET /cluster/ to get cluster node configuration.
GET /api/v1/cluster/nodes/<node-id> (Deprecated)

List the specified node's Network Interfaces


Returns the number of interfaces on the node and detailed
information about each interface. Interface information includes MTU,
broadcast and host IP addresses, link and admin status, MAC address, network
mask, and the IP configuration method (static or DHCP).
GET /api/v1/cluster/nodes/<node-id>/network/interfaces

Read the node's Network Interface


Returns detailed information about the specified interface. Interface
information includes MTU, broadcast and host IP addresses, link and admin
status, MAC address, network mask, and the IP configuration method (static
or DHCP).
GET /api/v1/cluster/nodes/<node-id>/network/interfaces/<interface-id>

Read the NSX Manager/Controller's Network Interface Statistics


On the specified interface, returns the number of received (rx), transmitted
(tx), and dropped packets; the number of bytes and errors received and
transmitted on the interface; and the number of detected collisions.
GET /api/v1/cluster/nodes/<node-id>/network/interfaces/<interface-id>/stats

Synchronizes the repository data between nsx managers.


Returns the synchronization status for the manager represented by given .
GET /api/v1/cluster/nodes/<node-id>/repo_sync/status

Read cluster node runtime status


Read aggregated runtime status of cluster node.
GET /api/v1/cluster/nodes/<node-id>/status

Returns info for all cluster node VM auto-deployment attempts


Returns request information for every attempted deployment of a cluster
node VM.
GET /api/v1/cluster/nodes/deployments

Deploy and register a cluster node VM


Deploys a cluster node VM as specified by the deployment config.
Once the VM is deployed and powered on, it will automatically join the
existing cluster.
POST /api/v1/cluster/nodes/deployments

Returns info for a cluster-node VM auto-deployment attempt


Returns deployment request information for a specific attempted
deployment of a cluster node VM.
GET /api/v1/cluster/nodes/deployments/<node-id>

Attempt to delete an auto-deployed cluster node VM


Attempts to unregister and undeploy a specified auto-deployed cluster
node VM. If it is a member of a cluster, then the VM will be automatically
detached from the cluster before being unregistered and undeployed.
Alternatively, if the original deployment attempt failed or the VM is
not found, cleans up the deployment information associated with the
deployment attempt.
Note: If a VM has been successfully auto-deployed, then the associated
deployment information will not be deleted unless and until the VM is
successfully deleted.
POST /api/v1/cluster/nodes/deployments/<node-id>?action=delete

Returns the status of the VM creation/deletion


Returns the current deployment or undeployment status for a VM along with
any other relevant current information, such as error messages.
GET /api/v1/cluster/nodes/deployments/<node-id>/status

Read cluster runtime status


Read aggregated runtime status of all cluster nodes.
Deprecated. Use GET /cluster/status instead.
GET /api/v1/cluster/nodes/status (Deprecated)

Read Cluster Status


Returns status information for the NSX cluster control role and management
role.
GET /api/v1/cluster/status

List all Central Node Config profiles


Returns list of all Central Node Config profiles.
GET /api/v1/configs/central-config/node-config-profiles/

Configure Node Config profile


Updates properties in the specified Central Node Config profile.
PUT /api/v1/configs/central-config/node-config-profiles/<node-config-profile-id>

Read Central Node Config profile


Returns properties in specified Central Node Config profile. Sensitive data
(like SNMP v2c community strings) are included only if query parameter
"show_sensitive_data" is true.
GET /api/v1/configs/central-config/node-config-profiles/<profile-id>

Return inventory configuration


Supports retrieving following configuration of inventory module
1. Soft limit on number of compute managers that can be registered.
GET /api/v1/configs/inventory

Read NSX Management nodes global configuration.


Returns the NSX Management nodes global configuration.
GET /api/v1/configs/management

Update NSX Management nodes global configuration


Modifies the NSX Management nodes global configuration.
PUT /api/v1/configs/management

NodeMode


Currently only a switch from "VMC_LOCAL" to "VMC" is supported.
Returns a new Node Mode, if the request successfuly changed it.
POST /api/v1/configs/node/mode

Scan the size of a directory domain


This call scans the size of a directory domain. It may be very | expensive to run this call in some AD domain deployments. Please | use it with caution.
POST /api/v1/directory/domain-size

List all configured domains


GET /api/v1/directory/domains

Create a directory domain


POST /api/v1/directory/domains

Delete a specific domain with given identifier


DELETE /api/v1/directory/domains/<domain-id>

Get a specific domain with given identifier


GET /api/v1/directory/domains/<domain-id>

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.


POST /api/v1/directory/domains/<domain-id>

Update a directory domain


Update to any field in the directory domain will trigger a full sync
PUT /api/v1/directory/domains/<domain-id>

Search for directory groups within a domain based on the substring of a distinguished name. (e.g. CN=User,DC=acme,DC=com) The search filter pattern can optionally support multiple (up to 100 maximum) search pattern separated by '|' (url encoded %7C). In this case, the search results will be returned as the union of all matching criteria. (e.g. CN=Ann,CN=Users,DC=acme,DC=com|CN=Bob,CN=Users,DC=acme,DC=com)


GET /api/v1/directory/domains/<domain-id>/groups

List members of a directory group


A member group could be either direct member of the group specified by group_id or nested member of it. Both direct member groups and nested member groups are returned.
GET /api/v1/directory/domains/<domain-id>/groups/<group-id>/member-groups

List all configured domain LDAP servers


GET /api/v1/directory/domains/<domain-id>/ldap-servers

Create a LDAP server for directory domain


More than one LDAP server can be created and only one LDAP server is used to synchronize directory objects. If more than one LDAP server is configured, NSX will try all the servers until it is able to successfully connect to one.
POST /api/v1/directory/domains/<domain-id>/ldap-servers

Delete a LDAP server for directory domain


DELETE /api/v1/directory/domains/<domain-id>/ldap-servers/<server-id>

Get a specific LDAP server for a given directory domain


GET /api/v1/directory/domains/<domain-id>/ldap-servers/<server-id>

Test a LDAP server connection for directory domain


The API tests a LDAP server connection for an already configured domain. If the connection is successful, the response will be HTTP status 200. Otherwise the response will be HTTP status 500 and corresponding error message will be returned.
POST /api/v1/directory/domains/<domain-id>/ldap-servers/<server-id>

Update a LDAP server for directory domain


PUT /api/v1/directory/domains/<domain-id>/ldap-servers/<server-id>

Get domain sync statistics for the given identifier


GET /api/v1/directory/domains/<domain-id>/sync-stats

Test a directory domain LDAP server connectivity


This API tests a LDAP server connectivity before the actual domain or LDAP server is configured. If the connectivity is good, the response will be HTTP status 200. Otherwise the response will be HTTP status 500 and corresponding error message will be returned.
POST /api/v1/directory/ldap-server

Fetch all organization units for a LDAP server.


POST /api/v1/directory/org-units

List Edge Clusters


Returns information about the configured edge clusters, which enable you to
group together transport nodes of the type EdgeNode and apply fabric
profiles to all members of the edge cluster. Each edge node can participate
in only one edge cluster.
GET /api/v1/edge-clusters

Create Edge Cluster


Creates a new edge cluster.
It only supports homogeneous members.
The TransportNodes backed by EdgeNode are only allowed in cluster members.
DeploymentType (VIRTUAL_MACHINE|PHYSICAL_MACHINE) of these EdgeNodes is
recommended to be the same. EdgeCluster supports members of different
deployment types.
POST /api/v1/edge-clusters

Delete Edge Cluster


Deletes the specified edge cluster.
DELETE /api/v1/edge-clusters/<edge-cluster-id>

Read Edge Cluster


Returns information about the specified edge cluster.
GET /api/v1/edge-clusters/<edge-cluster-id>

Replace the transport node in the specified member of the edge-cluster


Replace the transport node in the specified member of the edge-cluster.
This is a disruptive action. This will move all the LogicalRouterPorts(uplink and routerLink)
host on the old transport_node to the new transport_node. The transportNode cannot be
present in another member of any edgeClusters.
POST /api/v1/edge-clusters/<edge-cluster-id>?action=replace_transport_node

Update Edge Cluster


Modifies the specified edge cluster. Modifiable parameters include the
description, display_name, transport-node-id. If the optional
fabric_profile_binding is included, resource_type and profile_id are required.
User should do a GET on the edge-cluster and obtain the payload and retain the
member_index of the existing members as returning in the GET output. For new member
additions, the member_index cannot be defined by the user, user can read the system
allocated index to the new member in the output of this API call or by doing a GET call.
User cannot use this PUT api to replace the transport_node of an existing member because
this is a disruption action, we have exposed a explicit API for doing so, refer to
"ReplaceEdgeClusterMemberTransportNode"
EdgeCluster only supports homogeneous members. The TransportNodes backed by EdgeNode are
only allowed in cluster members. DeploymentType (VIRTUAL_MACHINE|PHYSICAL_MACHINE) of these
EdgeNodes is recommended to be the same. EdgeCluster supports members of different
deployment types.
PUT /api/v1/edge-clusters/<edge-cluster-id>

Get the Allocation details of an edge cluster


Returns the allocation details of cluster and its members. Lists the edge
node members, active and standby services of each node, utilization details
of configured sub-pools. These allocation details can be monitored by
customers to trigger migration of certain service contexts to different
edge nodes, to balance the utilization of edge node resources.
GET /api/v1/edge-clusters/<edge-cluster-id>/allocation-status

Get inter-site status of the edge cluster


Returns the aggregated status for the Edge cluster along with status of
all edge nodes in the cluster. It always returns cached response.
GET /api/v1/edge-clusters/<edge-cluster-id>/inter-site/status

Get the Realized State of a Edge Cluster


Return realized state information of a edge cluster.
Any configuration update that affects the edge cluster can use this API
to get its realized state by passing a request_id returned by the
configuration change operation. e.g. Update configuration of edge cluster.
GET /api/v1/edge-clusters/<edge-cluster-id>/state

Get the status for the Edge cluster of the given id


Returns the aggregated status for the Edge cluster along with status of
all edge nodes in the cluster. Query parameter "source=realtime" is the
only supported source.
GET /api/v1/edge-clusters/<edge-cluster-id>/status

Returns the List of cloud native service instances


Returns information about all cloud native service instances.
GET /api/v1/fabric/cloud-native-service-instances

Returns information about a particular cloud native service instance by external-id.


Returns information about a particular cloud native service instance
by external-id.
GET /api/v1/fabric/cloud-native-service-instances/<external-id>

Get compute collection fabric templates


Returns compute collection fabric templates. This functionality is deprecated. Use Transport Node Profiles instead of this template.
GET /api/v1/fabric/compute-collection-fabric-templates (Deprecated)

Create a compute collection fabric template


Fabric templates are fabric configurations applied at the compute collection level. This configurations is used to decide what automated operations should be a run when a host membership changes. This functionality is deprecated. Use Transport Node Profiles instead of this template.
POST /api/v1/fabric/compute-collection-fabric-templates (Deprecated)

Deletes compute collection fabric template


Deletes compute collection fabric template for the given id. This functionality is deprecated. Use Transport Node Profiles instead of this template.
DELETE /api/v1/fabric/compute-collection-fabric-templates/<fabric-template-id> (Deprecated)

Get compute collection fabric template by id


Get compute collection fabric template for the given id. This functionality is deprecated. Use Transport Node Profiles instead of this template.
GET /api/v1/fabric/compute-collection-fabric-templates/<fabric-template-id> (Deprecated)

Updates compute collection fabric template


Updates compute collection fabric template for the given id. This functionality is deprecated. Use Transport Node Profiles instead of this template.
PUT /api/v1/fabric/compute-collection-fabric-templates/<fabric-template-id> (Deprecated)

Return the List of Compute Collections


Returns information about all compute collections.
GET /api/v1/fabric/compute-collections

Return Compute Collection Information


Returns information about a specific compute collection.
GET /api/v1/fabric/compute-collections/<cc-ext-id>

Perform action specific to NSX on the compute-collection. cc-ext-id should be of type VC_Cluster.


POST /api/v1/fabric/compute-collections/<cc-ext-id>

Get status of member host nodes of the compute-collection. Only nsx prepared host nodes in the specified compute-collection are included in the response. cc-ext-id should be of type VC_Cluster.


GET /api/v1/fabric/compute-collections/<cc-ext-id>/member-status

List the Physical Network Interface for all discovered nodes


Returns list of physical network interfaces for all discovered nodes in
compute collection. Interface information includes PNIC name, hostswitch
name it's attached to(if any) and MAC address.
GET /api/v1/fabric/compute-collections/<cc-ext-id>/network/physical-interfaces

Return the List of Compute managers


Returns information about all compute managers.
GET /api/v1/fabric/compute-managers

Register compute manager with NSX


Registers compute manager with NSX. Inventory service will collect
data from the registered compute manager
POST /api/v1/fabric/compute-managers

Unregister a compute manager


Unregisters a specified compute manager
DELETE /api/v1/fabric/compute-managers/<compute-manager-id>

Return compute manager Information


Returns information about a specific compute manager
GET /api/v1/fabric/compute-managers/<compute-manager-id>

Update compute manager


Updates a specified compute manager
PUT /api/v1/fabric/compute-managers/<compute-manager-id>

Get the realized state of a compute manager


GET /api/v1/fabric/compute-managers/<compute-manager-id>/state

Return runtime status information for a compute manager


Returns connection and version information about a compute manager
GET /api/v1/fabric/compute-managers/<compute-manager-id>/status

Return the list of container application instance


Returns information about all container application instance.
GET /api/v1/fabric/container-application-instances

Return a container application instance


Returns information about a specific container application instance.
GET /api/v1/fabric/container-application-instances/<container-application-instance-id>

Return the List of Container Applications


Returns information about all Container Applications.
GET /api/v1/fabric/container-applications

Return a Container Application within a container project


Returns information about a specific Container Application within a project.
GET /api/v1/fabric/container-applications/<container-application-id>

Return the list of container cluster nodes


Returns information about all container cluster nodes.
GET /api/v1/fabric/container-cluster-nodes

Return a container cluster node


Returns information about a specific container cluster node.
GET /api/v1/fabric/container-cluster-nodes/<container-cluster-node-id>

Return the List of Container Clusters


Returns information about all Container Clusters.
GET /api/v1/fabric/container-clusters

Return a container cluster


Returns information about a specific container cluster
GET /api/v1/fabric/container-clusters/<container-cluster-id>

Return the List of Container Ingress Policies


Returns information about all ingress policies.
GET /api/v1/fabric/container-ingress-policies

Returns an ingress policy spec


Returns information about a specific ingress policy.
GET /api/v1/fabric/container-ingress-policies/<ingress-policy-id>

Return the List of Container Network Policies


Returns information about all network policies.
GET /api/v1/fabric/container-network-policies

Return a network policy spec


Returns information about a specific network policy.
GET /api/v1/fabric/container-network-policies/<network-policy-id>

Return the list of container projects


Returns information about all container projects
GET /api/v1/fabric/container-projects

Return a container project


Returns information about a specific project
GET /api/v1/fabric/container-projects/<container-project-id>

Return the List of Discovered Nodes


Returns information about all discovered nodes.
GET /api/v1/fabric/discovered-nodes

Return Discovered Node Information


Returns information about a specific discovered node.
GET /api/v1/fabric/discovered-nodes/<node-ext-id>

Apply cluster level config on Discovered Node


When transport node profile (TNP) is applied to a cluster, if any validation fails (e.g. VMs running on host) then transport node (TN) is not created. In that case after the required action is taken (e.g. VMs powered off), you can call this API to try to create TN for that discovered node.
Do not call this API if Transport Node already exists for the discovered node. In that case use API on transport node. /transport-nodes/?action=restore_cluster_config
POST /api/v1/fabric/discovered-nodes/<node-ext-id>?action=reapply_cluster_config

(Deprecated) Prepares discovered Node for NSX


Prepares(hostprep) discovered node for NSX. NSX LCP bundles are installed on this discovered node. This API is deprecated. Use /fabric/discovered-nodes/?action=create_transport_node
POST /api/v1/fabric/discovered-nodes/<node-ext-id>?action=hostprep (Deprecated)

Created Transport Node for Discovered Node


NSX components are installaed on host and transport node is created with given configurations.
POST /api/v1/fabric/discovered-nodes/<node-ext-id>?action=create_transport_node

Return the List of Nodes


Returns information about all fabric nodes (hosts and edges).
This api is deprecated as part of FN+TN unification. Please use Transport Node API
GET /transport-nodes to list all fabric nodes.
GET /api/v1/fabric/nodes (Deprecated)

Register and Install NSX Components on a Node


Creates a host node (hypervisor) or edge node (router) in the transport
network.

When you run this command for a host, NSX Manager attempts to install the
NSX kernel modules, which are packaged as VIB, RPM, or DEB files. For the
installation to succeed, you must provide the host login credentials and the
host thumbprint.

To get the ESXi host thumbprint, SSH to the host and run the
openssl x509 -in /etc/vmware/ssl/rui.crt -fingerprint -sha256 -noout
command.

To generate host key thumbprint using SHA-256 algorithm please follow the
steps below.

Log into the host, making sure that the connection is not vulnerable to a
man in the middle attack. Check whether a public key already exists.
Host public key is generally located at '/etc/ssh/ssh_host_rsa_key.pub'.
If the key is not present then generate a new key by running the following
command and follow the instructions.

ssh-keygen -t rsa

Now generate a SHA256 hash of the key using the following command. Please
make sure to pass the appropriate file name if the public key is stored with
a different file name other than the default 'id_rsa.pub'.

awk '{print $2}' id_rsa.pub | base64 -d | sha256sum -b | sed 's/ .*$//' | xxd -r -p | base64
This api is deprecated as part of FN+TN unification. Please use Transport Node API
POST /transport-nodes to install NSX components on a node.
POST /api/v1/fabric/nodes (Deprecated)

Delete a Node


Removes a specified fabric node (host or edge).
A fabric node may only be deleted when it is no longer referenced
by a Transport Node. If unprepare_host option is set to false, the
host will be deleted without uninstalling the NSX components from
the host.
This api is deprecated, use Transport Node API
DELETE /transport-nodes/<transport-node-id> to delete FN.
DELETE /transport-nodes/ to delete FN.
DELETE /api/v1/fabric/nodes/<node-id> (Deprecated)

Return Node Information


Returns information about a specific fabric node (host or edge).
This api is deprecated, use Transport Node API
GET /transport-nodes/<transport-node-id> to get fabric
node information.
GET /api/v1/fabric/nodes/<node-id> (Deprecated)

Perform an Action on Fabric Node


The supported fabric node actions are enter_maintenance_mode,
exit_maintenance_mode for EdgeNode.
This API is deprecated, please call TransportNode maintenance mode API to
update maintenance mode, refer to "Update transport node maintenance mode".
POST /api/v1/fabric/nodes/<node-id> (Deprecated)

Perform a service deployment upgrade on a host node


POST /api/v1/fabric/nodes/<node-id>?action=upgrade_infra

Restart the inventory sync for the node if it is paused currently.


Restart the inventory sync for the node if it is currently internally paused.
After this action the next inventory sync coming from the node is processed.
This api is deprecated as part of FN+TN unification. Please use Transport Node API
POST /transport-nodes/<transport-node-id>?action=restart_inventory_sync
to restart inventory sync of node.
POST /api/v1/fabric/nodes/<node-id>?action=restart_inventory_sync (Deprecated)

Update a Node


Modifies attributes of a fabric node (host or edge).
This api is deprecated as part of FN+TN unification. Please use Transport Node
API PUT /transport-nodes/<transport-node-id> to update fabric node details.
API PUT /transport-nodes/ to update fabric node details.
PUT /api/v1/fabric/nodes/<node-id> (Deprecated)

Return the List of Capabilities of a Single Node


Returns information about capabilities of a single fabric host node. Edge nodes do not have capabilities. This api is deprecated, use GET /transport-nodes/<transportnode-id>/capabilities if FN is converted to TN.
GET /api/v1/fabric/nodes/<node-id>/capabilities (Deprecated)

Get the module details of a Fabric Node This api is deprecated, use Transport Node API GET /transport-nodes/<transportnode-id>/modules to get fabric node modules.


GET /api/v1/fabric/nodes/<node-id>/modules (Deprecated)

List the specified node's Network Interfaces


Returns the number of interfaces on the node and detailed
information about each interface. Interface information includes MTU,
broadcast and host IP addresses, link and admin status, MAC address, network
mask, and the IP configuration method (static or DHCP).
This api is deprecated. Please use Transport Node API
GET /transport-nodes//network/interfaces
to list node network interfaces for the corresponding TN.
GET /api/v1/fabric/nodes/<node-id>/network/interfaces (Deprecated)

Read the node's Network Interface


Returns detailed information about the specified interface. Interface
information includes MTU, broadcast and host IP addresses, link and admin
status, MAC address, network mask, and the IP configuration method (static
or DHCP).
This api is deprecated as part of FN+TN unification. Please use Transport
Node API GET /transport-nodes//network/interfaces/
to get interface details of a node.
GET /api/v1/fabric/nodes/<node-id>/network/interfaces/<interface-id> (Deprecated)

Read the NSX Manager's Network Interface Statistics


On the specified interface, returns the number of received (rx), transmitted
(tx), and dropped packets; the number of bytes and errors received and
transmitted on the interface; and the number of detected collisions.
This api is deprecated as part of FN+TN unification. Please use
/transport-nodes//network/interfaces//stats to
read network interface statistics with contraint FN is converted to TN.
GET /api/v1/fabric/nodes/<node-id>/network/interfaces/<interface-id>/stats (Deprecated)

Get the Realized State of a Fabric Node.


For edge nodes, returns the current install
state when deployment is in progress, NODE_READY
when deployment is complete and the failure state
when deployment has failed.
This api is deprecated. Please use /transport-nodes/<transportnode-id>/state
to get realized state of a Fabric Node.
GET /api/v1/fabric/nodes/<node-id>/state (Deprecated)

Return Runtime Status Information for a Node


Returns connectivity, heartbeat, and version information about a fabric node
(host or edge). Note that the LCP connectivity status remains down until
after the fabric node has been added as a transpot node and the NSX host
switch has been successfully installed. See POST /api/v1/transport-nodes.
This api is deprecated, use GET /api/v1/transport-nodes/<node-id>/status to
get status information of a node with constraint FN is converted to TN.
GET /api/v1/fabric/nodes/<node-id>/status (Deprecated)

Invoke DELETE request on target fabric node


Invoke DELETE request on target fabric node. This api is deprecated
as part of FN+TN unification. Please use Transport Node API
DELETE /transport-nodes/<transport-node-id>/<target-node-id>/<target-uri>
DELETE /api/v1/fabric/nodes/<target-node-id>/<target-uri> (Deprecated)

Invoke GET request on target fabric node


Invoke GET request on target fabric node. This api is deprecated
as part of FN+TN unification. Please use Transport Node API
GET /transport-nodes/<transport-node-id>/<target-node-id>/<target-uri>
GET /api/v1/fabric/nodes/<target-node-id>/<target-uri> (Deprecated)

Invoke POST request on target fabric node


Invoke POST request on target fabric node. This api is deprecated
as part of FN+TN unification. Please use Transport Node API
POST /transport-nodes/<transport-node-id>/<target-node-id>/<target-uri>
POST /api/v1/fabric/nodes/<target-node-id>/<target-uri> (Deprecated)

Invoke PUT request on target fabric node


Invoke PUT request on target fabric node. This api is deprecated
as part of FN+TN unification. Please use Transport Node API
PUT /transport-nodes/<transport-node-id>/<target-node-id>/<target-uri>
PUT /api/v1/fabric/nodes/<target-node-id>/<target-uri> (Deprecated)

Return Runtime Status Information for given Nodes


Returns connectivity, heartbeat, and version information about all fabric nodes
(host or edge).
This api is deprecated as part of FN+TN unification. Please use Transport Node
Status API /transport-nodes/<node-id>/status to get status information of a node
and to get all transport nodes ids use GET /transport-nodes.
GET /api/v1/fabric/nodes/status (Deprecated)

Return list of supported host OS types


Returns names of all supported host OS.
GET /api/v1/fabric/ostypes

Return the list of physical servers


Returns information of all physical/bare metal servers registered as TN.
GET /api/v1/fabric/physical-servers

Return a specific physical server


Returns information about physical/bare metal server based on given transport node id.
GET /api/v1/fabric/physical-servers/<physical-server-id>

Return the List of Virtual Network Interfaces (VIFs)


Returns information about all VIFs. A virtual network interface aggregates
network interfaces into a logical interface unit that is indistinuishable
from a physical network interface.
GET /api/v1/fabric/vifs

Return the List of Virtual Machines


Returns information about all virtual machines.
GET /api/v1/fabric/virtual-machines

Perform action on specified virtual machine e.g. update tags


Perform action on a specific virtual machine. External id of the virtual machine needs to be
provided in the request body. Some of the actions that can be performed are update tags, add
tags, remove tags.
To add tags to existing list of tag, use action parameter add_tags.
To remove tags from existing list of tag, use action parameter remove_tags.
To replace existing tags with new tags, use action parameter update_tags.
To clear all tags, provide an empty list and action parameter as update_tags.
The vmw-async: True HTTP header cannot be used with this API.
POST /api/v1/fabric/virtual-machines?action=add_tags

Perform action on specified virtual machine e.g. update tags


Perform action on a specific virtual machine. External id of the virtual machine needs to be
provided in the request body. Some of the actions that can be performed are update tags, add
tags, remove tags.
To add tags to existing list of tag, use action parameter add_tags.
To remove tags from existing list of tag, use action parameter remove_tags.
To replace existing tags with new tags, use action parameter update_tags.
To clear all tags, provide an empty list and action parameter as update_tags.
The vmw-async: True HTTP header cannot be used with this API.
POST /api/v1/fabric/virtual-machines?action=remove_tags

Perform action on specified virtual machine e.g. update tags


Perform action on a specific virtual machine. External id of the virtual machine needs to be
provided in the request body. Some of the actions that can be performed are update tags, add
tags, remove tags.
To add tags to existing list of tag, use action parameter add_tags.
To remove tags from existing list of tag, use action parameter remove_tags.
To replace existing tags with new tags, use action parameter update_tags.
To clear all tags, provide an empty list and action parameter as update_tags.
The vmw-async: True HTTP header cannot be used with this API.
POST /api/v1/fabric/virtual-machines?action=update_tags

Return the list of tools and agents installed in VMs.


This API returns the list of tools and agents installed in VMs.
GET /api/v1/fabric/virtual-machines/tools-info

Return the List of Virtual Switches


Returns information about all virtual switches based on the
request parameters.
GET /api/v1/fabric/virtual-switches

List Failure Domains


Returns information about configured failure domains.
GET /api/v1/failure-domains

Create Failure Domain


Creates a new failure domain.
POST /api/v1/failure-domains

Delete Failure Domain


Deletes an existing failure domain. You can not delete system generated
default failure domain.
DELETE /api/v1/failure-domains/<failure-domain-id>

Get a Failure Domain


Returns information about a single failure domain.
GET /api/v1/failure-domains/<failure-domain-id>

Update Failure Domain


Updates an existing failure domain. Modifiable parameters are
display_name, preferred_active_edge_services flag.
PUT /api/v1/failure-domains/<failure-domain-id>

List global configurations of a NSX domain


Returns global configurations of a NSX domain grouped by the config types.
These global configurations are valid across NSX domain for their respective
types unless they are overridden by a more granular configurations.
GET /api/v1/global-configs

Get global configs for a config type


Returns global configurations that belong to the config type
GET /api/v1/global-configs/<config-type>

Resyncs global configurations of a config-type


It is similar to update global configurations but this request would trigger
update even if the configs are unmodified. However, the realization of the
new configurations is config-type specific. Refer to config-type
specific documentation for details about the configuration push state.
PUT /api/v1/global-configs/<config-type>?action=resync_config

Update global configurations of a config type


Updates global configurations that belong to a config type. The request must
include the updated values along with the unmodified values. The values that
are updated(different) would trigger update to config-type specific state.
However, the realization of the new configurations is config-type specific.
Refer to config-type specific documentation for details about the config-
uration push state.
Policy api will overwrite the fipsGlobalConfig set using MP api. Always use
https:///policy/api/v1/infra/global-config to update fips config-
uration.
PUT /api/v1/global-configs/<config-type>

List Hostswitch Profiles


Returns information about the configured hostswitch profiles. Hostswitch
profiles define networking policies for hostswitches (sometimes referred to
as bridges in OVS). Currently, only uplink teaming is supported. Uplink
teaming allows NSX to load balance traffic across different physical NICs
(PNICs) on the hypervisor hosts. Multiple teaming policies are supported,
including LACP active, LACP passive, load balancing based on source ID, and
failover order.
GET /api/v1/host-switch-profiles

Create a Hostswitch Profile


Creates a hostswitch profile. The resource_type is required. For uplink
profiles, the teaming and policy parameters are required. By default, the
mtu is 1600 and the transport_vlan is 0. The supported MTU range is 1280
through (uplink_mtu_threshold). (uplink_mtu_threshold) is 9000 by default.
Range can be extended by modifying (uplink_mtu_threshold) in
SwitchingGlobalConfig to the required upper threshold.
POST /api/v1/host-switch-profiles

Delete a Hostswitch Profile


Deletes a specified hostswitch profile.
DELETE /api/v1/host-switch-profiles/<host-switch-profile-id>

Get a Hostswitch Profile by ID


Returns information about a specified hostswitch profile.
GET /api/v1/host-switch-profiles/<host-switch-profile-id>

Update a Hostswitch Profile


Modifies a specified hostswitch profile. The body of the PUT request must
include the resource_type. For uplink profiles, the put request must also
include teaming parameters. Modifiable attributes include display_name, mtu,
and transport_vlan. For uplink teaming policies, uplink_name and policy are
also modifiable.
PUT /api/v1/host-switch-profiles/<host-switch-profile-id>

Get NSX-Intelligence host configuration


Get the current NSX-Intelligence host configuration.
Recommend to keep the value same for flow_data_collection_interval
and context_data_collection_interval.
GET /api/v1/intelligence/host-config

Patch NSX-Intelligence host configuration


Patch the current NSX-Intelligence host configuration.
Return error if NSX-Intelligence is not registered with NSX.
PATCH /api/v1/intelligence/host-config

Reset NSX-Intelligence host configuration


Reset NSX-Intelligence host configuration to the default setting.
Clear NSX-Intelligence host configuration if NSX-Intelligence is not registered with NSX.
Return the NSX-Intelligence host configuration after reset operation.
POST /api/v1/intelligence/host-config?action=reset

Returns info for all cluster node VM auto-deployment attempts


Returns request information for every attempted deployment of a cluster
node VM.
GET /api/v1/intelligence/nodes/deployments

Deploy and register a Intelligence cluster node VM


Deploys a Intelligence cluster node VM as specified by the deployment config.
POST /api/v1/intelligence/nodes/deployments

Returns info for a Intelligence cluster node VM auto-deployment attempt


Returns deployment request information for a specific attempted
deployment of a cluster node VM.
GET /api/v1/intelligence/nodes/deployments/<node-id>

Attempt to delete an auto-deployed cluster node VM


Attempts to unregister and undeploy a specified auto-deployed cluster
node VM. If it is a member of a cluster, then the VM will be automatically
detached from the cluster before being unregistered and undeployed.
Alternatively, if the original deployment attempt failed or the VM is
not found, cleans up the deployment information associated with the
deployment attempt.
Note: If a VM has been successfully auto-deployed, then the associated
deployment information will not be deleted unless and until the VM is
successfully deleted.
POST /api/v1/intelligence/nodes/deployments/<node-id>?action=delete

Returns the status of the VM creation/deletion


Returns the current deployment or undeployment status for a VM along with
any other relevant current information, such as error messages.
GET /api/v1/intelligence/nodes/deployments/<node-id>/status

List LLDP Neighbor Properties of Fabric Node


List LLDP Neighbor Properties for all interfaces of Fabric Node
GET /api/v1/lldp/fabric-nodes/<fabric-node-id>/interfaces

Read LLDP Neighbor Properties of Fabric Node by Interface Name


Read LLDP Neighbor Properties for a specific interface of Fabric Node
GET /api/v1/lldp/fabric-nodes/<fabric-node-id>/interfaces/<interface-name>

List LLDP Neighbor Properties of Transport Node


List LLDP Neighbor Properties for all interfaces of Transport Node
GET /api/v1/lldp/transport-nodes/<node-id>/interfaces

Read LLDP Neighbor Properties of Transport Node by Interface Name


Read LLDP Neighbor Properties for a specific interface of Transport Node
GET /api/v1/lldp/transport-nodes/<node-id>/interfaces/<interface-name>

Read node properties


Returns information about the NSX appliance. Information includes
release number, time zone, system time, kernel version, message of the day
(motd), and host name.
GET /api/v1/node
GET /api/v1/transport-nodes/<transport-node-id>/node
GET /api/v1/cluster/<cluster-node-id>/node

Restart or shutdown node


Restarts or shuts down the NSX appliance.
POST /api/v1/node?action=restart|shutdown
POST /api/v1/transport-nodes/<transport-node-id>/node?action=restart|shutdown
POST /api/v1/cluster/<cluster-node-id>/node?action=restart|shutdown

Set the node system time


Set the node system time to the given time in UTC in the RFC3339 format
'yyyy-mm-ddThh:mm:ssZ'.
POST /api/v1/node?action=set_system_time
POST /api/v1/transport-nodes/<transport-node-id>/node?action=set_system_time
POST /api/v1/cluster/<cluster-node-id>/node?action=set_system_time

Update node properties


Modifies NSX appliance properties. Modifiable properties include the
timezone, message of the day (motd), and hostname. The NSX appliance
node_version, system_time, and kernel_version are read only and cannot be
modified with this method.
PUT /api/v1/node
PUT /api/v1/transport-nodes/<transport-node-id>/node
PUT /api/v1/cluster/<cluster-node-id>/node

Read node authentication policy configuration


Returns information about the currently configured authentication
policies on the node.
GET /api/v1/node/aaa/auth-policy
GET /api/v1/transport-nodes/<transport-node-id>/node/aaa/auth-policy
GET /api/v1/cluster/<cluster-node-id>/node/aaa/auth-policy

Update node authentication policy configuration


Update the currently configured authentication policy on the node.
If any of api_max_auth_failures, api_failed_auth_reset_period, or
api_failed_auth_lockout_period are modified, the http service is
automatically restarted.
PUT /api/v1/node/aaa/auth-policy
PUT /api/v1/transport-nodes/<transport-node-id>/node/aaa/auth-policy
PUT /api/v1/cluster/<cluster-node-id>/node/aaa/auth-policy

Read Central Config properties


GET /api/v1/node/central-config
GET /api/v1/transport-nodes/<transport-node-id>/node/central-config
GET /api/v1/cluster/<cluster-node-id>/node/central-config

Update Central Config properties


PUT /api/v1/node/central-config
PUT /api/v1/transport-nodes/<transport-node-id>/node/central-config
PUT /api/v1/cluster/<cluster-node-id>/node/central-config

Read node certificate properties


GET /api/v1/node/certificate
GET /api/v1/transport-nodes/<transport-node-id>/node/certificate
GET /api/v1/cluster/<cluster-node-id>/node/certificate

Current configuration for this node


GET /api/v1/node/configuration
GET /api/v1/transport-nodes/<transport-node-id>/node/configuration
GET /api/v1/cluster/<cluster-node-id>/node/configuration

Read edge config diagnosis


GET /api/v1/node/diagnosis
GET /api/v1/transport-nodes/<transport-node-id>/node/diagnosis
GET /api/v1/cluster/<cluster-node-id>/node/diagnosis

List node files


GET /api/v1/node/file-store
GET /api/v1/transport-nodes/<transport-node-id>/node/file-store
GET /api/v1/cluster/<cluster-node-id>/node/file-store

Create directory in remote file server


Create a directory on the remote remote server. Supports only SFTP.
You must provide the remote server's SSH fingerprint. See the
NSX Administration Guide for information and instructions
about finding the SSH fingerprint.
POST /api/v1/node/file-store?action=create_remote_directory
POST /api/v1/transport-nodes/<transport-node-id>/node/file-store?action=create_remote_directory
POST /api/v1/cluster/<cluster-node-id>/node/file-store?action=create_remote_directory

Delete file


DELETE /api/v1/node/file-store/<file-name>
DELETE /api/v1/transport-nodes/<transport-node-id>/node/file-store/<file-name>
DELETE /api/v1/cluster/<cluster-node-id>/node/file-store/<file-name>

Read file properties


GET /api/v1/node/file-store/<file-name>
GET /api/v1/transport-nodes/<transport-node-id>/node/file-store/<file-name>
GET /api/v1/cluster/<cluster-node-id>/node/file-store/<file-name>

Copy a remote file to the file store


Copy a remote file to the file store. If you use scp or sftp,
you must provide the remote server's SSH fingerprint. See the
NSX-T Administration Guide for information and instructions
about finding the SSH fingerprint.
POST /api/v1/node/file-store/<file-name>?action=copy_from_remote_file
POST /api/v1/transport-nodes/<transport-node-id>/node/file-store/<file-name>?action=copy_from_remote_file
POST /api/v1/cluster/<cluster-node-id>/node/file-store/<file-name>?action=copy_from_remote_file

Upload a file to the file store


When you issue this API, the client must specify:
- HTTP header Content-Type:application/octet-stream.
- Request body with the contents of the file in the filestore.
In the CLI, you can view the filestore with the get files command.
POST /api/v1/node/file-store/<file-name>
POST /api/v1/transport-nodes/<transport-node-id>/node/file-store/<file-name>
POST /api/v1/cluster/<cluster-node-id>/node/file-store/<file-name>

Copy file in the file store to a remote file store


Copy a file in the file store to a remote server. If you use scp or
sftp, you must provide the remote server's SSH fingerprint. See the
NSX-T Administration Guide for information and instructions
about finding the SSH fingerprint.
POST /api/v1/node/file-store/<file-name>?action=copy_to_remote_file
POST /api/v1/transport-nodes/<transport-node-id>/node/file-store/<file-name>?action=copy_to_remote_file
POST /api/v1/cluster/<cluster-node-id>/node/file-store/<file-name>?action=copy_to_remote_file

Read file contents


GET /api/v1/node/file-store/<file-name>/data
GET /api/v1/transport-nodes/<transport-node-id>/node/file-store/<file-name>/data
GET /api/v1/cluster/<cluster-node-id>/node/file-store/<file-name>/data

Replace file contents


PUT /api/v1/node/file-store/<file-name>/data
PUT /api/v1/transport-nodes/<transport-node-id>/node/file-store/<file-name>/data
PUT /api/v1/cluster/<cluster-node-id>/node/file-store/<file-name>/data

Read file thumbprint


GET /api/v1/node/file-store/<file-name>/thumbprint
GET /api/v1/transport-nodes/<transport-node-id>/node/file-store/<file-name>/thumbprint
GET /api/v1/cluster/<cluster-node-id>/node/file-store/<file-name>/thumbprint

Get NSX Edge stateful flows


GET /api/v1/node/flows
GET /api/v1/transport-nodes/<transport-node-id>/node/flows
GET /api/v1/cluster/<cluster-node-id>/node/flows

Get NSX Edge stateful flows by interface


GET /api/v1/node/flows/interfaces/<iface-uuid>
GET /api/v1/transport-nodes/<transport-node-id>/node/flows/interfaces/<iface-uuid>
GET /api/v1/cluster/<cluster-node-id>/node/flows/interfaces/<iface-uuid>

Get NSX Edge stateful flows by router


GET /api/v1/node/flows/logical-routers/<uuid>
GET /api/v1/transport-nodes/<transport-node-id>/node/flows/logical-routers/<uuid>
GET /api/v1/cluster/<cluster-node-id>/node/flows/logical-routers/<uuid>

Gets the enable status for Mandatory Access Control


GET /api/v1/node/hardening-policy/mandatory-access-control
GET /api/v1/transport-nodes/<transport-node-id>/node/hardening-policy/mandatory-access-control
GET /api/v1/cluster/<cluster-node-id>/node/hardening-policy/mandatory-access-control

Enable or disable Mandatory Access Control


PUT /api/v1/node/hardening-policy/mandatory-access-control
PUT /api/v1/transport-nodes/<transport-node-id>/node/hardening-policy/mandatory-access-control
PUT /api/v1/cluster/<cluster-node-id>/node/hardening-policy/mandatory-access-control

Get the report for Mandatory Access Control


GET /api/v1/node/hardening-policy/mandatory-access-control/report
GET /api/v1/transport-nodes/<transport-node-id>/node/hardening-policy/mandatory-access-control/report
GET /api/v1/cluster/<cluster-node-id>/node/hardening-policy/mandatory-access-control/report

Read consolidated appliance health info


GET /api/v1/node/intelligence/appliance-health (Experimental)
GET /api/v1/transport-nodes/<transport-node-id>/node/intelligence/appliance-health (Experimental)
GET /api/v1/cluster/<cluster-node-id>/node/intelligence/appliance-health (Experimental)

List available NSX Intelligence appliance features and operations


Returns information about NSX Intelligence appliance features and operations.
And their availability based on lisence, form factor and user's roles.
Also return metadata about NSX Intelligence appliance and logged-in user.
GET /api/v1/node/intelligence/features-operations
GET /api/v1/transport-nodes/<transport-node-id>/node/intelligence/features-operations
GET /api/v1/cluster/<cluster-node-id>/node/intelligence/features-operations

List available NSX Intelligence appliance form factors


Returns information about all form factors available for intelligence nodes
GET /api/v1/node/intelligence/form-factors
GET /api/v1/transport-nodes/<transport-node-id>/node/intelligence/form-factors
GET /api/v1/cluster/<cluster-node-id>/node/intelligence/form-factors

List available NSX Intelligence UI features and permissions


Returns information about NSX Intelligence appliance UI features and
permissions.
And their availability based on lisence, form factor and current user's
roles.
GET /api/v1/node/intelligence/ui-plugin-permissions
GET /api/v1/transport-nodes/<transport-node-id>/node/intelligence/ui-plugin-permissions
GET /api/v1/cluster/<cluster-node-id>/node/intelligence/ui-plugin-permissions

Logical-router diagnosis


Returns information of specified logical-router configured on edge.
GET /api/v1/node/logical-routers/<logical-router-id>/diagnosis
GET /api/v1/transport-nodes/<transport-node-id>/node/logical-routers/<logical-router-id>/diagnosis
GET /api/v1/cluster/<cluster-node-id>/node/logical-routers/<logical-router-id>/diagnosis

Logical-routers diagnosis


Returns information of all logical-routers or specified type of
logical-routers configured on edge.
GET /api/v1/node/logical-routers/diagnosis
GET /api/v1/transport-nodes/<transport-node-id>/node/logical-routers/diagnosis
GET /api/v1/cluster/<cluster-node-id>/node/logical-routers/diagnosis

List available node logs


Returns the number of log files and lists the log files that reside on the
NSX virtual appliance. The list includes the filename, file size,
and last-modified time in milliseconds since epoch (1 January 1970) for each
log file. Knowing the last-modified time with millisecond accuracy since
epoch is helpful when you are comparing two times, such as the time of a
POST request and the end time on a server.
GET /api/v1/node/logs
GET /api/v1/transport-nodes/<transport-node-id>/node/logs
GET /api/v1/cluster/<cluster-node-id>/node/logs

Read node log properties


For a single specified log file, lists the filename, file size, and
last-modified time.
GET /api/v1/node/logs/<log-name>
GET /api/v1/transport-nodes/<transport-node-id>/node/logs/<log-name>
GET /api/v1/cluster/<cluster-node-id>/node/logs/<log-name>

Read node log contents


For a single specified log file, returns the content of the log file.
This method supports byte-range requests. To request just a portion of a
log file, supply an HTTP Range header, e.g. "Range: bytes=-".
is optional, and, if omitted, the file contents from start to the
end of the file are returned.'
GET /api/v1/node/logs/<log-name>/data
GET /api/v1/transport-nodes/<transport-node-id>/node/logs/<log-name>/data
GET /api/v1/cluster/<cluster-node-id>/node/logs/<log-name>/data

Get Edge maintenance mode


GET /api/v1/node/maintenance-mode
GET /api/v1/transport-nodes/<transport-node-id>/node/maintenance-mode
GET /api/v1/cluster/<cluster-node-id>/node/maintenance-mode

Set Edge maintenance mode


PUT /api/v1/node/maintenance-mode
PUT /api/v1/transport-nodes/<transport-node-id>/node/maintenance-mode
PUT /api/v1/cluster/<cluster-node-id>/node/maintenance-mode

Delete management plane configuration for this node


Delete the management plane configuration for this node.
DELETE /api/v1/node/management-plane
DELETE /api/v1/transport-nodes/<transport-node-id>/node/management-plane
DELETE /api/v1/cluster/<cluster-node-id>/node/management-plane

Get management plane configuration for this node


Retrieve the management plane configuration for this node to identify the Manager node with which the controller service is communicating.
GET /api/v1/node/management-plane (Experimental)
GET /api/v1/transport-nodes/<transport-node-id>/node/management-plane (Experimental)
GET /api/v1/cluster/<cluster-node-id>/node/management-plane (Experimental)

Update management plane configuration for this node


Update the management plane configuration for this node.
PUT /api/v1/node/management-plane (Experimental)
PUT /api/v1/transport-nodes/<transport-node-id>/node/management-plane (Experimental)
PUT /api/v1/cluster/<cluster-node-id>/node/management-plane (Experimental)

NodeMode


Returns current Node Mode.
GET /api/v1/node/mode
GET /api/v1/transport-nodes/<transport-node-id>/node/mode
GET /api/v1/cluster/<cluster-node-id>/node/mode

Delete MPA configuration for this node


Delete the MPA configuration for this node.
DELETE /api/v1/node/mpa-config
DELETE /api/v1/transport-nodes/<transport-node-id>/node/mpa-config
DELETE /api/v1/cluster/<cluster-node-id>/node/mpa-config

Get MPA configuration for this node


Retrieve the MPA configuration for this node to identify the Manager nodes with which this node is communicating.
GET /api/v1/node/mpa-config (Experimental)
GET /api/v1/transport-nodes/<transport-node-id>/node/mpa-config (Experimental)
GET /api/v1/cluster/<cluster-node-id>/node/mpa-config (Experimental)

Update MPA configuration for this node


Update the MPA configuration for this node.
PUT /api/v1/node/mpa-config (Experimental)
PUT /api/v1/transport-nodes/<transport-node-id>/node/mpa-config (Experimental)
PUT /api/v1/cluster/<cluster-node-id>/node/mpa-config (Experimental)

Update management plane agent configuration and restart MPA


PUT /api/v1/node/mpa-config?action=restart (Experimental)
PUT /api/v1/transport-nodes/<transport-node-id>/node/mpa-config?action=restart (Experimental)
PUT /api/v1/cluster/<cluster-node-id>/node/mpa-config?action=restart (Experimental)

Read network configuration properties


GET /api/v1/node/network
GET /api/v1/transport-nodes/<transport-node-id>/node/network
GET /api/v1/cluster/<cluster-node-id>/node/network

List the Node's Network Interfaces


Returns the number of interfaces on the node appliance and detailed
information about each interface. Interface information includes MTU,
broadcast and host IP addresses, link and admin status, MAC address, network
mask, and the IP configuration method (static or DHCP).
GET /api/v1/node/network/interfaces
GET /api/v1/transport-nodes/<transport-node-id>/node/network/interfaces
GET /api/v1/cluster/<cluster-node-id>/node/network/interfaces

Read the Node's Network Interface


Returns detailed information about the specified interface. Interface
information includes MTU, broadcast and host IP addresses, link and admin
status, MAC address, network mask, and the IP configuration method.
GET /api/v1/node/network/interfaces/<interface-id>
GET /api/v1/transport-nodes/<transport-node-id>/node/network/interfaces/<interface-id>
GET /api/v1/cluster/<cluster-node-id>/node/network/interfaces/<interface-id>

Update the Node's Network Interface


Updates the specified interface properties. You cannot change
the properties ip_configuration,
ip_addresses, or plane. NSX
Manager must have a static IP address.
You must use NSX CLI to configure a controller or an edge node.
PUT /api/v1/node/network/interfaces/<interface-id>
PUT /api/v1/transport-nodes/<transport-node-id>/node/network/interfaces/<interface-id>
PUT /api/v1/cluster/<cluster-node-id>/node/network/interfaces/<interface-id>

Read the Node's Network Interface Statistics


On the specified interface, returns the number of received (rx), transmitted
(tx), and dropped packets; the number of bytes and errors received and
transmitted on the interface; and the number of detected collisions.
GET /api/v1/node/network/interfaces/<interface-id>/stats
GET /api/v1/transport-nodes/<transport-node-id>/node/network/interfaces/<interface-id>/stats
GET /api/v1/cluster/<cluster-node-id>/node/network/interfaces/<interface-id>/stats

Read the Node's Name Servers


Returns the list of servers that the node uses to look up IP
addresses associated with given domain names.
GET /api/v1/node/network/name-servers
GET /api/v1/transport-nodes/<transport-node-id>/node/network/name-servers
GET /api/v1/cluster/<cluster-node-id>/node/network/name-servers

Update the Node's Name Servers


Modifies the list of servers that the node uses to look up IP
addresses associated with given domain names. If DHCP is configured, this
method returns a 409 CONFLICT error, because DHCP manages the list of name
servers.
PUT /api/v1/node/network/name-servers
PUT /api/v1/transport-nodes/<transport-node-id>/node/network/name-servers
PUT /api/v1/cluster/<cluster-node-id>/node/network/name-servers

List node network routes


Returns detailed information about each route in the node routing
table. Route information includes the route type (default, static, and so
on), a unique route identifier, the route metric, the protocol from which
the route was learned, the route source (which is the preferred egress
interface), the route destination, and the route scope. The route scope
refers to the distance to the destination network: The "host" scope leads to
a destination address on the node, such as a loopback address;
the "link" scope leads to a destination on the local network; and the
"global" scope leads to addresses that are more than one hop away.
GET /api/v1/node/network/routes
GET /api/v1/transport-nodes/<transport-node-id>/node/network/routes
GET /api/v1/cluster/<cluster-node-id>/node/network/routes

Create node network route


Add a route to the node routing table. For static routes, the
route_type, interface_id, netmask, and destination are required parameters.
For default routes, the route_type, gateway address, and interface_id
are required. For blackhole routes, the route_type and destination are
required. All other parameters are optional. When you add a static route,
the scope and route_id are created automatically. When you add a default or
blackhole route, the route_id is created automatically. The route_id is
read-only, meaning that it cannot be modified. All other properties can be
modified by deleting and readding the route.
POST /api/v1/node/network/routes
POST /api/v1/transport-nodes/<transport-node-id>/node/network/routes
POST /api/v1/cluster/<cluster-node-id>/node/network/routes

Delete node network route


Delete a route from the node routing table. You can modify an
existing route by deleting it and then posting the modified version of the
route. To verify, remove the route ID from the URI, issue a GET request, and
note the absense of the deleted route.
DELETE /api/v1/node/network/routes/<route-id>
DELETE /api/v1/transport-nodes/<transport-node-id>/node/network/routes/<route-id>
DELETE /api/v1/cluster/<cluster-node-id>/node/network/routes/<route-id>

Read node network route


Returns detailed information about a specified route in the node
routing table.
GET /api/v1/node/network/routes/<route-id>
GET /api/v1/transport-nodes/<transport-node-id>/node/network/routes/<route-id>
GET /api/v1/cluster/<cluster-node-id>/node/network/routes/<route-id>

Read the Node's Search Domains


Returns the domain list that the node uses to complete
unqualified host names. When a host name does not include a fully
qualified domain name (FQDN), the NSX Management node appends the
first-listed domain name to the host name before the host name is looked
up. The NSX Management node continues this for each entry in the domain
list until it finds a match.
GET /api/v1/node/network/search-domains
GET /api/v1/transport-nodes/<transport-node-id>/node/network/search-domains
GET /api/v1/cluster/<cluster-node-id>/node/network/search-domains

Update the Node's Search Domains


Modifies the list of domain names that the node uses to complete
unqualified host names. If DHCP is configured, this method returns
a 409 CONFLICT error, because DHCP manages the list of name servers.
PUT /api/v1/node/network/search-domains
PUT /api/v1/transport-nodes/<transport-node-id>/node/network/search-domains
PUT /api/v1/cluster/<cluster-node-id>/node/network/search-domains

List node processes


Returns the number of processes and information about each
process. Process information includes 1) mem_resident, which is roughly
equivalent to the amount of RAM, in bytes, currently used by the process,
2) parent process ID (ppid), 3) process name, 4) process up time in milliseconds,
5) mem_used, wich is the amount of virtual memory used by the process, in
bytes, 6) process start time, in milliseconds since epoch, 7) process ID
(pid), 8) CPU time, both user and the system, consumed by the process in
milliseconds.
GET /api/v1/node/processes
GET /api/v1/transport-nodes/<transport-node-id>/node/processes
GET /api/v1/cluster/<cluster-node-id>/node/processes

Read node process


Returns information for a specified process ID (pid).
GET /api/v1/node/processes/<process-id>
GET /api/v1/transport-nodes/<transport-node-id>/node/processes/<process-id>
GET /api/v1/cluster/<cluster-node-id>/node/processes/<process-id>

Delete RabbitMQ management port


DELETE /api/v1/node/rabbitmq-management-port
DELETE /api/v1/transport-nodes/<transport-node-id>/node/rabbitmq-management-port
DELETE /api/v1/cluster/<cluster-node-id>/node/rabbitmq-management-port

Check if RabbitMQ management port is enabled or not


Returns status as true if RabbitMQ management port is enabled else false
GET /api/v1/node/rabbitmq-management-port
GET /api/v1/transport-nodes/<transport-node-id>/node/rabbitmq-management-port
GET /api/v1/cluster/<cluster-node-id>/node/rabbitmq-management-port

Set RabbitMQ management port


POST /api/v1/node/rabbitmq-management-port
POST /api/v1/transport-nodes/<transport-node-id>/node/rabbitmq-management-port
POST /api/v1/cluster/<cluster-node-id>/node/rabbitmq-management-port

List node services


Returns a list of all services available on the node applicance.
GET /api/v1/node/services
GET /api/v1/transport-nodes/<transport-node-id>/node/services
GET /api/v1/cluster/<cluster-node-id>/node/services

Read the Async Replicator service properties


GET /api/v1/node/services/async_replicator
GET /api/v1/transport-nodes/<transport-node-id>/node/services/async_replicator
GET /api/v1/cluster/<cluster-node-id>/node/services/async_replicator

Restart, start or stop the Async Replicator service


POST /api/v1/node/services/async_replicator?action=restart|start|stop
POST /api/v1/transport-nodes/<transport-node-id>/node/services/async_replicator?action=restart|start|stop
POST /api/v1/cluster/<cluster-node-id>/node/services/async_replicator?action=restart|start|stop

Update the async_replicator service properties


PUT /api/v1/node/services/async_replicator
PUT /api/v1/transport-nodes/<transport-node-id>/node/services/async_replicator
PUT /api/v1/cluster/<cluster-node-id>/node/services/async_replicator

Read the Async Replicator service status


GET /api/v1/node/services/async_replicator/status
GET /api/v1/transport-nodes/<transport-node-id>/node/services/async_replicator/status
GET /api/v1/cluster/<cluster-node-id>/node/services/async_replicator/status

Read cluster boot manager service properties


GET /api/v1/node/services/cluster_manager
GET /api/v1/transport-nodes/<transport-node-id>/node/services/cluster_manager
GET /api/v1/cluster/<cluster-node-id>/node/services/cluster_manager

Restart, start or stop the cluster boot manager service


POST /api/v1/node/services/cluster_manager?action=start|stop|restart
POST /api/v1/transport-nodes/<transport-node-id>/node/services/cluster_manager?action=start|stop|restart
POST /api/v1/cluster/<cluster-node-id>/node/services/cluster_manager?action=start|stop|restart

Read cluster boot manager service status


GET /api/v1/node/services/cluster_manager/status
GET /api/v1/transport-nodes/<transport-node-id>/node/services/cluster_manager/status
GET /api/v1/cluster/<cluster-node-id>/node/services/cluster_manager/status

Read cm inventory service properties


GET /api/v1/node/services/cm-inventory
GET /api/v1/transport-nodes/<transport-node-id>/node/services/cm-inventory
GET /api/v1/cluster/<cluster-node-id>/node/services/cm-inventory

Restart, start or stop the manager service


POST /api/v1/node/services/cm-inventory?action=start|stop|restart
POST /api/v1/transport-nodes/<transport-node-id>/node/services/cm-inventory?action=start|stop|restart
POST /api/v1/cluster/<cluster-node-id>/node/services/cm-inventory?action=start|stop|restart

Read manager service status


GET /api/v1/node/services/cm-inventory/status
GET /api/v1/transport-nodes/<transport-node-id>/node/services/cm-inventory/status
GET /api/v1/cluster/<cluster-node-id>/node/services/cm-inventory/status

Read controller service properties


GET /api/v1/node/services/controller
GET /api/v1/transport-nodes/<transport-node-id>/node/services/controller
GET /api/v1/cluster/<cluster-node-id>/node/services/controller

Restart, start or stop the controller service


POST /api/v1/node/services/controller?action=restart|start|stop
POST /api/v1/transport-nodes/<transport-node-id>/node/services/controller?action=restart|start|stop
POST /api/v1/cluster/<cluster-node-id>/node/services/controller?action=restart|start|stop

Read controller server certificate properties


GET /api/v1/node/services/controller/controller-certificate
GET /api/v1/transport-nodes/<transport-node-id>/node/services/controller/controller-certificate
GET /api/v1/cluster/<cluster-node-id>/node/services/controller/controller-certificate

Get the status (Enabled/Disabled) of controller profiler


GET /api/v1/node/services/controller/profiler
GET /api/v1/transport-nodes/<transport-node-id>/node/services/controller/profiler
GET /api/v1/cluster/<cluster-node-id>/node/services/controller/profiler

Enable or disable controller profiler


PUT /api/v1/node/services/controller/profiler
PUT /api/v1/transport-nodes/<transport-node-id>/node/services/controller/profiler
PUT /api/v1/cluster/<cluster-node-id>/node/services/controller/profiler

Read controller service status


GET /api/v1/node/services/controller/status
GET /api/v1/transport-nodes/<transport-node-id>/node/services/controller/status
GET /api/v1/cluster/<cluster-node-id>/node/services/controller/status

Read NSX EdgeDatapath service properties


GET /api/v1/node/services/dataplane
GET /api/v1/transport-nodes/<transport-node-id>/node/services/dataplane
GET /api/v1/cluster/<cluster-node-id>/node/services/dataplane

Restart, start or stop the NSX EdgeDatapath service


POST /api/v1/node/services/dataplane?action=restart|start|stop
POST /api/v1/transport-nodes/<transport-node-id>/node/services/dataplane?action=restart|start|stop
POST /api/v1/cluster/<cluster-node-id>/node/services/dataplane?action=restart|start|stop

Update NSX Edge Datapath service properties


PUT /api/v1/node/services/dataplane
PUT /api/v1/transport-nodes/<transport-node-id>/node/services/dataplane
PUT /api/v1/cluster/<cluster-node-id>/node/services/dataplane

Get NSX Edge dataplane cpu stats


GET /api/v1/node/services/dataplane/cpu-stats
GET /api/v1/transport-nodes/<transport-node-id>/node/services/dataplane/cpu-stats
GET /api/v1/cluster/<cluster-node-id>/node/services/dataplane/cpu-stats

Update NSX Edge dataplane control packets prioritization setting


Enable or disable NSX Edge dataplane control packets prioritization.
Dataplane service must be restarted for the change to take effect.
PUT /api/v1/node/services/dataplane/ctrl-prio
PUT /api/v1/transport-nodes/<transport-node-id>/node/services/dataplane/ctrl-prio
PUT /api/v1/cluster/<cluster-node-id>/node/services/dataplane/ctrl-prio

Get NSX Edge dataplane flow cache setting


GET /api/v1/node/services/dataplane/flow-cache
GET /api/v1/transport-nodes/<transport-node-id>/node/services/dataplane/flow-cache
GET /api/v1/cluster/<cluster-node-id>/node/services/dataplane/flow-cache

Update NSX Edge dataplane flow cache setting


Enable or disable NSX Edge dataplane flow cache. Dataplane service must be
restarted for the change to take effect.
PUT /api/v1/node/services/dataplane/flow-cache
PUT /api/v1/transport-nodes/<transport-node-id>/node/services/dataplane/flow-cache
PUT /api/v1/cluster/<cluster-node-id>/node/services/dataplane/flow-cache

Return top 10 flows information


Run flow monitor for timeout seconds for all or certain CPU core(s)
and return top 10 flows.
GET /api/v1/node/services/dataplane/flow-mon
GET /api/v1/transport-nodes/<transport-node-id>/node/services/dataplane/flow-mon
GET /api/v1/cluster/<cluster-node-id>/node/services/dataplane/flow-mon

Start NSX Edge dataplane flow monitor


Starts NSX Edge dataplane flow monitor on all or certain CPU core(s) with a timeout.
Stops flow monitor after timeout and dumps the flow file on local file store
on edge. If top_10 argument is set to true top 10 flows are collected,
else all flows are collected.
PUT /api/v1/node/services/dataplane/flow-mon
PUT /api/v1/transport-nodes/<transport-node-id>/node/services/dataplane/flow-mon
PUT /api/v1/cluster/<cluster-node-id>/node/services/dataplane/flow-mon

Get NSX Edge dataplane firewall connections


GET /api/v1/node/services/dataplane/fw-conns
GET /api/v1/transport-nodes/<transport-node-id>/node/services/dataplane/fw-conns
GET /api/v1/cluster/<cluster-node-id>/node/services/dataplane/fw-conns

Get NSX Edge dataplane firewall stats


GET /api/v1/node/services/dataplane/fw-stats
GET /api/v1/transport-nodes/<transport-node-id>/node/services/dataplane/fw-stats
GET /api/v1/cluster/<cluster-node-id>/node/services/dataplane/fw-stats

Get NSX Edge dataplane geneve cbit setting


GET /api/v1/node/services/dataplane/geneve-cbit
GET /api/v1/transport-nodes/<transport-node-id>/node/services/dataplane/geneve-cbit
GET /api/v1/cluster/<cluster-node-id>/node/services/dataplane/geneve-cbit

Update NSX Edge dataplane geneve cbit setting


Enable or disable NSX Edge dataplane geneve critical bit.
PUT /api/v1/node/services/dataplane/geneve-cbit
PUT /api/v1/transport-nodes/<transport-node-id>/node/services/dataplane/geneve-cbit
PUT /api/v1/cluster/<cluster-node-id>/node/services/dataplane/geneve-cbit

Update NSX Edge dataplane interrupt mode setting


Enable or disable NSX Edge dataplane interrupt mode.
Dataplane service must be restarted for the change to take effect.
PUT /api/v1/node/services/dataplane/intr-mode
PUT /api/v1/transport-nodes/<transport-node-id>/node/services/dataplane/intr-mode
PUT /api/v1/cluster/<cluster-node-id>/node/services/dataplane/intr-mode

Get NSX Edge dataplane l2vpn pmtu setting


GET /api/v1/node/services/dataplane/l2vpn-pmtu
GET /api/v1/transport-nodes/<transport-node-id>/node/services/dataplane/l2vpn-pmtu
GET /api/v1/cluster/<cluster-node-id>/node/services/dataplane/l2vpn-pmtu

Update NSX Edge dataplane l2vpn pmtu setting


Enable or disable NSX Edge dataplane pmtu cache in l2vpn.
PUT /api/v1/node/services/dataplane/l2vpn-pmtu
PUT /api/v1/transport-nodes/<transport-node-id>/node/services/dataplane/l2vpn-pmtu
PUT /api/v1/cluster/<cluster-node-id>/node/services/dataplane/l2vpn-pmtu

Get NSX Edge dataplane l3vpn pmtu setting


GET /api/v1/node/services/dataplane/l3vpn-pmtu
GET /api/v1/transport-nodes/<transport-node-id>/node/services/dataplane/l3vpn-pmtu
GET /api/v1/cluster/<cluster-node-id>/node/services/dataplane/l3vpn-pmtu

Update NSX Edge dataplane l3vpn pmtu setting


Enable or disable NSX Edge dataplane pmtu cache in l3vpn.
PUT /api/v1/node/services/dataplane/l3vpn-pmtu
PUT /api/v1/transport-nodes/<transport-node-id>/node/services/dataplane/l3vpn-pmtu
PUT /api/v1/cluster/<cluster-node-id>/node/services/dataplane/l3vpn-pmtu

Update NSX Edge dataplane QAT feature enabled status


Enable or disable NSX Edge dataplane QAT feature. Dataplane service must be
restarted for the change to take effect.
PUT /api/v1/node/services/dataplane/qat-enable
PUT /api/v1/transport-nodes/<transport-node-id>/node/services/dataplane/qat-enable
PUT /api/v1/cluster/<cluster-node-id>/node/services/dataplane/qat-enable

Get NSX Edge dataplane QAT setting


GET /api/v1/node/services/dataplane/qat-status
GET /api/v1/transport-nodes/<transport-node-id>/node/services/dataplane/qat-status
GET /api/v1/cluster/<cluster-node-id>/node/services/dataplane/qat-status

Return rx/tx ring size information


GET /api/v1/node/services/dataplane/ring-size
GET /api/v1/transport-nodes/<transport-node-id>/node/services/dataplane/ring-size
GET /api/v1/cluster/<cluster-node-id>/node/services/dataplane/ring-size

Set NSX Edge rx ring size for physical ports


Set NSX Edge rx ring size for physical ports.
Dataplane service must be restarted for the change to take effect.
PUT /api/v1/node/services/dataplane/rx-ring-size
PUT /api/v1/transport-nodes/<transport-node-id>/node/services/dataplane/rx-ring-size
PUT /api/v1/cluster/<cluster-node-id>/node/services/dataplane/rx-ring-size

Read NSX EdgeDatapath service status


GET /api/v1/node/services/dataplane/status
GET /api/v1/transport-nodes/<transport-node-id>/node/services/dataplane/status
GET /api/v1/cluster/<cluster-node-id>/node/services/dataplane/status

Set NSX Edge tx ring size for physical ports


Set NSX Edge tx ring size for physical ports.
Dataplane service must be restarted for the change to take effect.
PUT /api/v1/node/services/dataplane/tx-ring-size
PUT /api/v1/transport-nodes/<transport-node-id>/node/services/dataplane/tx-ring-size
PUT /api/v1/cluster/<cluster-node-id>/node/services/dataplane/tx-ring-size

Read NSX Edge DHCP service properties


GET /api/v1/node/services/dhcp
GET /api/v1/transport-nodes/<transport-node-id>/node/services/dhcp
GET /api/v1/cluster/<cluster-node-id>/node/services/dhcp

Update NSX Edge DHCP service properties


PUT /api/v1/node/services/dhcp
PUT /api/v1/transport-nodes/<transport-node-id>/node/services/dhcp
PUT /api/v1/cluster/<cluster-node-id>/node/services/dhcp

Read NSX Edge DHCP service status


GET /api/v1/node/services/dhcp/status
GET /api/v1/transport-nodes/<transport-node-id>/node/services/dhcp/status
GET /api/v1/cluster/<cluster-node-id>/node/services/dhcp/status

Read NSX Edge Dispatcher service properties


GET /api/v1/node/services/dispatcher
GET /api/v1/transport-nodes/<transport-node-id>/node/services/dispatcher
GET /api/v1/cluster/<cluster-node-id>/node/services/dispatcher

Restart, start or stop the NSX Edge Dispatcher service


POST /api/v1/node/services/dispatcher?action=restart|start|stop
POST /api/v1/transport-nodes/<transport-node-id>/node/services/dispatcher?action=restart|start|stop
POST /api/v1/cluster/<cluster-node-id>/node/services/dispatcher?action=restart|start|stop

Read NSX Edge Dispatcher service status


GET /api/v1/node/services/dispatcher/status
GET /api/v1/transport-nodes/<transport-node-id>/node/services/dispatcher/status
GET /api/v1/cluster/<cluster-node-id>/node/services/dispatcher/status

Read Druid service properties


GET /api/v1/node/services/druid
GET /api/v1/transport-nodes/<transport-node-id>/node/services/druid
GET /api/v1/cluster/<cluster-node-id>/node/services/druid

Restart, start or stop the Druid service


POST /api/v1/node/services/druid?action=restart|start|stop
POST /api/v1/transport-nodes/<transport-node-id>/node/services/druid?action=restart|start|stop
POST /api/v1/cluster/<cluster-node-id>/node/services/druid?action=restart|start|stop

Read Druid service status


GET /api/v1/node/services/druid/status
GET /api/v1/transport-nodes/<transport-node-id>/node/services/druid/status
GET /api/v1/cluster/<cluster-node-id>/node/services/druid/status

Read http service properties


This API is deprecated. Read the configuration of the
http service by calling the GET /api/v1/cluster/api-service API.
GET /api/v1/node/services/http (Deprecated)
GET /api/v1/transport-nodes/<transport-node-id>/node/services/http (Deprecated)
GET /api/v1/cluster/<cluster-node-id>/node/services/http (Deprecated)

Update http service certificate


Applies a security certificate to the http service. In the POST request,
the CERTIFICATE_ID references a certificate created with the
/api/v1/trust-management APIs. If the certificate used is a CA signed
certificate,the request fails if the whole chain(leaf, intermediate, root)
is not imported.
POST /api/v1/node/services/http?action=apply_certificate
POST /api/v1/transport-nodes/<transport-node-id>/node/services/http?action=apply_certificate
POST /api/v1/cluster/<cluster-node-id>/node/services/http?action=apply_certificate

Stop the http service


POST /api/v1/node/services/http?action=stop
POST /api/v1/transport-nodes/<transport-node-id>/node/services/http?action=stop
POST /api/v1/cluster/<cluster-node-id>/node/services/http?action=stop

Start the http service


POST /api/v1/node/services/http?action=start
POST /api/v1/transport-nodes/<transport-node-id>/node/services/http?action=start
POST /api/v1/cluster/<cluster-node-id>/node/services/http?action=start

Restart the http service


POST /api/v1/node/services/http?action=restart
POST /api/v1/transport-nodes/<transport-node-id>/node/services/http?action=restart
POST /api/v1/cluster/<cluster-node-id>/node/services/http?action=restart

Update http service properties


This API is deprecated. Make changes to the http service
configuration by calling the PUT /api/v1/cluster/api-service API.
PUT /api/v1/node/services/http (Deprecated)
PUT /api/v1/transport-nodes/<transport-node-id>/node/services/http (Deprecated)
PUT /api/v1/cluster/<cluster-node-id>/node/services/http (Deprecated)

Read http service status


GET /api/v1/node/services/http/status
GET /api/v1/transport-nodes/<transport-node-id>/node/services/http/status
GET /api/v1/cluster/<cluster-node-id>/node/services/http/status

Read the idps-reporting service properties


GET /api/v1/node/services/idps-reporting
GET /api/v1/transport-nodes/<transport-node-id>/node/services/idps-reporting
GET /api/v1/cluster/<cluster-node-id>/node/services/idps-reporting

Restart, start or stop the idps-reporting service


POST /api/v1/node/services/idps-reporting?action=restart|start|stop
POST /api/v1/transport-nodes/<transport-node-id>/node/services/idps-reporting?action=restart|start|stop
POST /api/v1/cluster/<cluster-node-id>/node/services/idps-reporting?action=restart|start|stop

Read the idps-reporting service status


GET /api/v1/node/services/idps-reporting/status
GET /api/v1/transport-nodes/<transport-node-id>/node/services/idps-reporting/status
GET /api/v1/cluster/<cluster-node-id>/node/services/idps-reporting/status

Read NSX install-upgrade service properties


GET /api/v1/node/services/install-upgrade
GET /api/v1/transport-nodes/<transport-node-id>/node/services/install-upgrade
GET /api/v1/cluster/<cluster-node-id>/node/services/install-upgrade

Restart, start or stop the NSX install-upgrade service


POST /api/v1/node/services/install-upgrade?action=restart|start|stop
POST /api/v1/transport-nodes/<transport-node-id>/node/services/install-upgrade?action=restart|start|stop
POST /api/v1/cluster/<cluster-node-id>/node/services/install-upgrade?action=restart|start|stop

Update NSX install-upgrade service properties


PUT /api/v1/node/services/install-upgrade
PUT /api/v1/transport-nodes/<transport-node-id>/node/services/install-upgrade
PUT /api/v1/cluster/<cluster-node-id>/node/services/install-upgrade

Read NSX install-upgrade service status


GET /api/v1/node/services/install-upgrade/status
GET /api/v1/transport-nodes/<transport-node-id>/node/services/install-upgrade/status
GET /api/v1/cluster/<cluster-node-id>/node/services/install-upgrade/status

Update UC state properties


PUT /api/v1/node/services/install-upgrade/uc-state
PUT /api/v1/transport-nodes/<transport-node-id>/node/services/install-upgrade/uc-state
PUT /api/v1/cluster/<cluster-node-id>/node/services/install-upgrade/uc-state

Read intelligence upgrade coordinator service properties


GET /api/v1/node/services/intelligence-upgrade-coordinator
GET /api/v1/transport-nodes/<transport-node-id>/node/services/intelligence-upgrade-coordinator
GET /api/v1/cluster/<cluster-node-id>/node/services/intelligence-upgrade-coordinator

Restart, start or stop the intelligence upgrade coordinator service


POST /api/v1/node/services/intelligence-upgrade-coordinator?action=start|stop|restart
POST /api/v1/transport-nodes/<transport-node-id>/node/services/intelligence-upgrade-coordinator?action=start|stop|restart
POST /api/v1/cluster/<cluster-node-id>/node/services/intelligence-upgrade-coordinator?action=start|stop|restart

Read intelligence upgrade coordinator service status


GET /api/v1/node/services/intelligence-upgrade-coordinator/status
GET /api/v1/transport-nodes/<transport-node-id>/node/services/intelligence-upgrade-coordinator/status
GET /api/v1/cluster/<cluster-node-id>/node/services/intelligence-upgrade-coordinator/status

Read NSX Edge Ipsec VPN service properties


Read the IPsec VPN service process properties from Edge.
GET /api/v1/node/services/ipsecvpn
GET /api/v1/transport-nodes/<transport-node-id>/node/services/ipsecvpn
GET /api/v1/cluster/<cluster-node-id>/node/services/ipsecvpn

Update NSX Edge Ipsec VPN service properties


PUT /api/v1/node/services/ipsecvpn
PUT /api/v1/transport-nodes/<transport-node-id>/node/services/ipsecvpn
PUT /api/v1/cluster/<cluster-node-id>/node/services/ipsecvpn

Read NSX Edge Ipsec VPN service status


Checks the status of iked process on the Edge.
If iked process is running, returns "running",
returns "stopped" otherwise.
GET /api/v1/node/services/ipsecvpn/status
GET /api/v1/transport-nodes/<transport-node-id>/node/services/ipsecvpn/status
GET /api/v1/cluster/<cluster-node-id>/node/services/ipsecvpn/status

Read Kafka service properties


GET /api/v1/node/services/kafka
GET /api/v1/transport-nodes/<transport-node-id>/node/services/kafka
GET /api/v1/cluster/<cluster-node-id>/node/services/kafka

Restart, start or stop the Kafka service


POST /api/v1/node/services/kafka?action=restart|start|stop
POST /api/v1/transport-nodes/<transport-node-id>/node/services/kafka?action=restart|start|stop
POST /api/v1/cluster/<cluster-node-id>/node/services/kafka?action=restart|start|stop

Read Kafka service status


GET /api/v1/node/services/kafka/status
GET /api/v1/transport-nodes/<transport-node-id>/node/services/kafka/status
GET /api/v1/cluster/<cluster-node-id>/node/services/kafka/status

Read liagent service properties


GET /api/v1/node/services/liagent
GET /api/v1/transport-nodes/<transport-node-id>/node/services/liagent
GET /api/v1/cluster/<cluster-node-id>/node/services/liagent

Restart, start or stop the liagent service


POST /api/v1/node/services/liagent?action=restart|start|stop
POST /api/v1/transport-nodes/<transport-node-id>/node/services/liagent?action=restart|start|stop
POST /api/v1/cluster/<cluster-node-id>/node/services/liagent?action=restart|start|stop

Read liagent service status


GET /api/v1/node/services/liagent/status
GET /api/v1/transport-nodes/<transport-node-id>/node/services/liagent/status
GET /api/v1/cluster/<cluster-node-id>/node/services/liagent/status

Read NSX Edge NSXA service properties


GET /api/v1/node/services/local-controller
GET /api/v1/transport-nodes/<transport-node-id>/node/services/local-controller
GET /api/v1/cluster/<cluster-node-id>/node/services/local-controller

Restart, start or stop the NSX EdgeNSXA service


POST /api/v1/node/services/local-controller?action=restart|start|stop
POST /api/v1/transport-nodes/<transport-node-id>/node/services/local-controller?action=restart|start|stop
POST /api/v1/cluster/<cluster-node-id>/node/services/local-controller?action=restart|start|stop

Update NSX Edge NSXA service properties


PUT /api/v1/node/services/local-controller
PUT /api/v1/transport-nodes/<transport-node-id>/node/services/local-controller
PUT /api/v1/cluster/<cluster-node-id>/node/services/local-controller

Read NSX EdgeNSXA service status


GET /api/v1/node/services/local-controller/status
GET /api/v1/transport-nodes/<transport-node-id>/node/services/local-controller/status
GET /api/v1/cluster/<cluster-node-id>/node/services/local-controller/status

Read service properties


GET /api/v1/node/services/manager
GET /api/v1/transport-nodes/<transport-node-id>/node/services/manager
GET /api/v1/cluster/<cluster-node-id>/node/services/manager

Reset the logging levels to default values


POST /api/v1/node/services/manager?action=reset-manager-logging-levels
POST /api/v1/transport-nodes/<transport-node-id>/node/services/manager?action=reset-manager-logging-levels
POST /api/v1/cluster/<cluster-node-id>/node/services/manager?action=reset-manager-logging-levels

Restart, start or stop the service


POST /api/v1/node/services/manager?action=start|stop|restart
POST /api/v1/transport-nodes/<transport-node-id>/node/services/manager?action=start|stop|restart
POST /api/v1/cluster/<cluster-node-id>/node/services/manager?action=start|stop|restart

Update service properties


PUT /api/v1/node/services/manager
PUT /api/v1/transport-nodes/<transport-node-id>/node/services/manager
PUT /api/v1/cluster/<cluster-node-id>/node/services/manager

Read service status


GET /api/v1/node/services/manager/status
GET /api/v1/transport-nodes/<transport-node-id>/node/services/manager/status
GET /api/v1/cluster/<cluster-node-id>/node/services/manager/status

Read Metadata-proxy service properties


GET /api/v1/node/services/metadata-proxy
GET /api/v1/transport-nodes/<transport-node-id>/node/services/metadata-proxy
GET /api/v1/cluster/<cluster-node-id>/node/services/metadata-proxy

Read Metadata-proxy service status


GET /api/v1/node/services/metadata-proxy/status
GET /api/v1/transport-nodes/<transport-node-id>/node/services/metadata-proxy/status
GET /api/v1/cluster/<cluster-node-id>/node/services/metadata-proxy/status

Read Rabbit MQ service properties


GET /api/v1/node/services/mgmt-plane-bus
GET /api/v1/transport-nodes/<transport-node-id>/node/services/mgmt-plane-bus
GET /api/v1/cluster/<cluster-node-id>/node/services/mgmt-plane-bus

Restart, start or stop the Rabbit MQ service


POST /api/v1/node/services/mgmt-plane-bus?action=restart|start|stop
POST /api/v1/transport-nodes/<transport-node-id>/node/services/mgmt-plane-bus?action=restart|start|stop
POST /api/v1/cluster/<cluster-node-id>/node/services/mgmt-plane-bus?action=restart|start|stop

Read Rabbit MQ service status


GET /api/v1/node/services/mgmt-plane-bus/status
GET /api/v1/transport-nodes/<transport-node-id>/node/services/mgmt-plane-bus/status
GET /api/v1/cluster/<cluster-node-id>/node/services/mgmt-plane-bus/status

Read migration coordinator service properties


GET /api/v1/node/services/migration-coordinator
GET /api/v1/transport-nodes/<transport-node-id>/node/services/migration-coordinator
GET /api/v1/cluster/<cluster-node-id>/node/services/migration-coordinator

Restart, start or stop the migration coordinator service


POST /api/v1/node/services/migration-coordinator?action=start|stop|restart
POST /api/v1/transport-nodes/<transport-node-id>/node/services/migration-coordinator?action=start|stop|restart
POST /api/v1/cluster/<cluster-node-id>/node/services/migration-coordinator?action=start|stop|restart

Read migration coordinator service status


GET /api/v1/node/services/migration-coordinator/status
GET /api/v1/transport-nodes/<transport-node-id>/node/services/migration-coordinator/status
GET /api/v1/cluster/<cluster-node-id>/node/services/migration-coordinator/status

Read NSX Nestdb service properties


GET /api/v1/node/services/nestdb
GET /api/v1/transport-nodes/<transport-node-id>/node/services/nestdb
GET /api/v1/cluster/<cluster-node-id>/node/services/nestdb

Restart, start or stop the NSX Nestdb service


POST /api/v1/node/services/nestdb?action=restart|start|stop
POST /api/v1/transport-nodes/<transport-node-id>/node/services/nestdb?action=restart|start|stop
POST /api/v1/cluster/<cluster-node-id>/node/services/nestdb?action=restart|start|stop

Read NSX Nestdb service status


GET /api/v1/node/services/nestdb/status
GET /api/v1/transport-nodes/<transport-node-id>/node/services/nestdb/status
GET /api/v1/cluster/<cluster-node-id>/node/services/nestdb/status

Read appliance management service properties


GET /api/v1/node/services/node-mgmt
GET /api/v1/transport-nodes/<transport-node-id>/node/services/node-mgmt
GET /api/v1/cluster/<cluster-node-id>/node/services/node-mgmt

Restart the node management service


POST /api/v1/node/services/node-mgmt?action=restart
POST /api/v1/transport-nodes/<transport-node-id>/node/services/node-mgmt?action=restart
POST /api/v1/cluster/<cluster-node-id>/node/services/node-mgmt?action=restart

Read appliance management service status


GET /api/v1/node/services/node-mgmt/status
GET /api/v1/transport-nodes/<transport-node-id>/node/services/node-mgmt/status
GET /api/v1/cluster/<cluster-node-id>/node/services/node-mgmt/status

Read NSX node-stats service properties


GET /api/v1/node/services/node-stats
GET /api/v1/transport-nodes/<transport-node-id>/node/services/node-stats
GET /api/v1/cluster/<cluster-node-id>/node/services/node-stats

Restart, start or stop the NSX node-stats service


POST /api/v1/node/services/node-stats?action=restart|start|stop
POST /api/v1/transport-nodes/<transport-node-id>/node/services/node-stats?action=restart|start|stop
POST /api/v1/cluster/<cluster-node-id>/node/services/node-stats?action=restart|start|stop

Read NSX node-stats service status


GET /api/v1/node/services/node-stats/status
GET /api/v1/transport-nodes/<transport-node-id>/node/services/node-stats/status
GET /api/v1/cluster/<cluster-node-id>/node/services/node-stats/status

Read NsxConfig service properties


GET /api/v1/node/services/nsx-config
GET /api/v1/transport-nodes/<transport-node-id>/node/services/nsx-config
GET /api/v1/cluster/<cluster-node-id>/node/services/nsx-config

Restart, start or stop the NsxConfig service


POST /api/v1/node/services/nsx-config?action=restart|start|stop
POST /api/v1/transport-nodes/<transport-node-id>/node/services/nsx-config?action=restart|start|stop
POST /api/v1/cluster/<cluster-node-id>/node/services/nsx-config?action=restart|start|stop

Read NsxConfig service status


GET /api/v1/node/services/nsx-config/status
GET /api/v1/transport-nodes/<transport-node-id>/node/services/nsx-config/status
GET /api/v1/cluster/<cluster-node-id>/node/services/nsx-config/status

Read NSX Control Plane Agent service properties


GET /api/v1/node/services/nsx-control-plane-agent
GET /api/v1/transport-nodes/<transport-node-id>/node/services/nsx-control-plane-agent
GET /api/v1/cluster/<cluster-node-id>/node/services/nsx-control-plane-agent

Restart, start or stop the NSX Control Plane Agent service


POST /api/v1/node/services/nsx-control-plane-agent?action=restart|start|stop
POST /api/v1/transport-nodes/<transport-node-id>/node/services/nsx-control-plane-agent?action=restart|start|stop
POST /api/v1/cluster/<cluster-node-id>/node/services/nsx-control-plane-agent?action=restart|start|stop

Read NSX Control Plane Agent service status


GET /api/v1/node/services/nsx-control-plane-agent/status
GET /api/v1/transport-nodes/<transport-node-id>/node/services/nsx-control-plane-agent/status
GET /api/v1/cluster/<cluster-node-id>/node/services/nsx-control-plane-agent/status

Read NSX Message Bus service properties


GET /api/v1/node/services/nsx-message-bus
GET /api/v1/transport-nodes/<transport-node-id>/node/services/nsx-message-bus
GET /api/v1/cluster/<cluster-node-id>/node/services/nsx-message-bus

Restart, start or stop the NSX Message Bus service


POST /api/v1/node/services/nsx-message-bus?action=restart|start|stop
POST /api/v1/transport-nodes/<transport-node-id>/node/services/nsx-message-bus?action=restart|start|stop
POST /api/v1/cluster/<cluster-node-id>/node/services/nsx-message-bus?action=restart|start|stop

Read NSX Message Bus service status


GET /api/v1/node/services/nsx-message-bus/status
GET /api/v1/transport-nodes/<transport-node-id>/node/services/nsx-message-bus/status
GET /api/v1/cluster/<cluster-node-id>/node/services/nsx-message-bus/status

Read NSX OpsAgent service properties


GET /api/v1/node/services/nsx-opsagent
GET /api/v1/transport-nodes/<transport-node-id>/node/services/nsx-opsagent
GET /api/v1/cluster/<cluster-node-id>/node/services/nsx-opsagent

Restart, start or stop the NSX OpsAgent service


POST /api/v1/node/services/nsx-opsagent?action=restart|start|stop
POST /api/v1/transport-nodes/<transport-node-id>/node/services/nsx-opsagent?action=restart|start|stop
POST /api/v1/cluster/<cluster-node-id>/node/services/nsx-opsagent?action=restart|start|stop

Read NSX OpsAgent service status


GET /api/v1/node/services/nsx-opsagent/status
GET /api/v1/transport-nodes/<transport-node-id>/node/services/nsx-opsagent/status
GET /api/v1/cluster/<cluster-node-id>/node/services/nsx-opsagent/status

Read NSX Platform Client service properties


GET /api/v1/node/services/nsx-platform-client
GET /api/v1/transport-nodes/<transport-node-id>/node/services/nsx-platform-client
GET /api/v1/cluster/<cluster-node-id>/node/services/nsx-platform-client

Restart, start or stop the NSX Platform Client service


POST /api/v1/node/services/nsx-platform-client?action=restart|start|stop
POST /api/v1/transport-nodes/<transport-node-id>/node/services/nsx-platform-client?action=restart|start|stop
POST /api/v1/cluster/<cluster-node-id>/node/services/nsx-platform-client?action=restart|start|stop

Read NSX Platform Client service status


GET /api/v1/node/services/nsx-platform-client/status
GET /api/v1/transport-nodes/<transport-node-id>/node/services/nsx-platform-client/status
GET /api/v1/cluster/<cluster-node-id>/node/services/nsx-platform-client/status

Read NSX upgrade Agent service properties


GET /api/v1/node/services/nsx-upgrade-agent
GET /api/v1/transport-nodes/<transport-node-id>/node/services/nsx-upgrade-agent
GET /api/v1/cluster/<cluster-node-id>/node/services/nsx-upgrade-agent

Restart, start or stop the NSX upgrade agent service


POST /api/v1/node/services/nsx-upgrade-agent?action=restart|start|stop
POST /api/v1/transport-nodes/<transport-node-id>/node/services/nsx-upgrade-agent?action=restart|start|stop
POST /api/v1/cluster/<cluster-node-id>/node/services/nsx-upgrade-agent?action=restart|start|stop

Read Nsx upgrade agent service status


GET /api/v1/node/services/nsx-upgrade-agent/status
GET /api/v1/transport-nodes/<transport-node-id>/node/services/nsx-upgrade-agent/status
GET /api/v1/cluster/<cluster-node-id>/node/services/nsx-upgrade-agent/status

Read NTP service properties


GET /api/v1/node/services/ntp
GET /api/v1/transport-nodes/<transport-node-id>/node/services/ntp
GET /api/v1/cluster/<cluster-node-id>/node/services/ntp

Restart, start or stop the NTP service


POST /api/v1/node/services/ntp?action=restart|start|stop
POST /api/v1/transport-nodes/<transport-node-id>/node/services/ntp?action=restart|start|stop
POST /api/v1/cluster/<cluster-node-id>/node/services/ntp?action=restart|start|stop

Update NTP service properties


PUT /api/v1/node/services/ntp
PUT /api/v1/transport-nodes/<transport-node-id>/node/services/ntp
PUT /api/v1/cluster/<cluster-node-id>/node/services/ntp

Read NTP service status


GET /api/v1/node/services/ntp/status
GET /api/v1/transport-nodes/<transport-node-id>/node/services/ntp/status
GET /api/v1/cluster/<cluster-node-id>/node/services/ntp/status

Read PaceServer service properties


GET /api/v1/node/services/pace-server
GET /api/v1/transport-nodes/<transport-node-id>/node/services/pace-server
GET /api/v1/cluster/<cluster-node-id>/node/services/pace-server

Restart, start or stop the PaceServer service


POST /api/v1/node/services/pace-server?action=restart|start|stop
POST /api/v1/transport-nodes/<transport-node-id>/node/services/pace-server?action=restart|start|stop
POST /api/v1/cluster/<cluster-node-id>/node/services/pace-server?action=restart|start|stop

Read PaceServer service status


GET /api/v1/node/services/pace-server/status
GET /api/v1/transport-nodes/<transport-node-id>/node/services/pace-server/status
GET /api/v1/cluster/<cluster-node-id>/node/services/pace-server/status

Read service properties


GET /api/v1/node/services/policy
GET /api/v1/transport-nodes/<transport-node-id>/node/services/policy
GET /api/v1/cluster/<cluster-node-id>/node/services/policy

Restart, start or stop the service


POST /api/v1/node/services/policy?action=start|stop|restart
POST /api/v1/transport-nodes/<transport-node-id>/node/services/policy?action=start|stop|restart
POST /api/v1/cluster/<cluster-node-id>/node/services/policy?action=start|stop|restart

Reset the logging levels to default values


POST /api/v1/node/services/policy?action=reset-manager-logging-levels
POST /api/v1/transport-nodes/<transport-node-id>/node/services/policy?action=reset-manager-logging-levels
POST /api/v1/cluster/<cluster-node-id>/node/services/policy?action=reset-manager-logging-levels

Update service properties


PUT /api/v1/node/services/policy
PUT /api/v1/transport-nodes/<transport-node-id>/node/services/policy
PUT /api/v1/cluster/<cluster-node-id>/node/services/policy

Read service status


GET /api/v1/node/services/policy/status
GET /api/v1/transport-nodes/<transport-node-id>/node/services/policy/status
GET /api/v1/cluster/<cluster-node-id>/node/services/policy/status

Read Postgres service properties


GET /api/v1/node/services/postgres
GET /api/v1/transport-nodes/<transport-node-id>/node/services/postgres
GET /api/v1/cluster/<cluster-node-id>/node/services/postgres

Restart, start or stop the Postgres service


POST /api/v1/node/services/postgres?action=restart|start|stop
POST /api/v1/transport-nodes/<transport-node-id>/node/services/postgres?action=restart|start|stop
POST /api/v1/cluster/<cluster-node-id>/node/services/postgres?action=restart|start|stop

Read Postgres service status


GET /api/v1/node/services/postgres/status
GET /api/v1/transport-nodes/<transport-node-id>/node/services/postgres/status
GET /api/v1/cluster/<cluster-node-id>/node/services/postgres/status

Read Processing service properties


GET /api/v1/node/services/processing
GET /api/v1/transport-nodes/<transport-node-id>/node/services/processing
GET /api/v1/cluster/<cluster-node-id>/node/services/processing

Restart, start or stop the Processing service


POST /api/v1/node/services/processing?action=restart|start|stop
POST /api/v1/transport-nodes/<transport-node-id>/node/services/processing?action=restart|start|stop
POST /api/v1/cluster/<cluster-node-id>/node/services/processing?action=restart|start|stop

Read Processing service status


GET /api/v1/node/services/processing/status
GET /api/v1/transport-nodes/<transport-node-id>/node/services/processing/status
GET /api/v1/cluster/<cluster-node-id>/node/services/processing/status

Read NSX EdgeMSR service properties


GET /api/v1/node/services/router
GET /api/v1/transport-nodes/<transport-node-id>/node/services/router
GET /api/v1/cluster/<cluster-node-id>/node/services/router

Read NSX EdgeMSRConfig service properties


GET /api/v1/node/services/router-config
GET /api/v1/transport-nodes/<transport-node-id>/node/services/router-config
GET /api/v1/cluster/<cluster-node-id>/node/services/router-config

Read NSX EdgeMSRConfig service status


GET /api/v1/node/services/router-config/status
GET /api/v1/transport-nodes/<transport-node-id>/node/services/router-config/status
GET /api/v1/cluster/<cluster-node-id>/node/services/router-config/status

Read NSX EdgeMSR service status


GET /api/v1/node/services/router/status
GET /api/v1/transport-nodes/<transport-node-id>/node/services/router/status
GET /api/v1/cluster/<cluster-node-id>/node/services/router/status

Read NSX Search service properties


GET /api/v1/node/services/search
GET /api/v1/transport-nodes/<transport-node-id>/node/services/search
GET /api/v1/cluster/<cluster-node-id>/node/services/search

Restart, start or stop the NSX Search service


POST /api/v1/node/services/search?action=restart|start|stop
POST /api/v1/transport-nodes/<transport-node-id>/node/services/search?action=restart|start|stop
POST /api/v1/cluster/<cluster-node-id>/node/services/search?action=restart|start|stop

Read NSX Search service status


GET /api/v1/node/services/search/status
GET /api/v1/transport-nodes/<transport-node-id>/node/services/search/status
GET /api/v1/cluster/<cluster-node-id>/node/services/search/status

Read SNMP service properties


Read SNMP service properties.
GET /api/v1/node/services/snmp
GET /api/v1/transport-nodes/<transport-node-id>/node/services/snmp
GET /api/v1/cluster/<cluster-node-id>/node/services/snmp

Restart, start or stop the SNMP service


POST /api/v1/node/services/snmp?action=restart|start|stop
POST /api/v1/transport-nodes/<transport-node-id>/node/services/snmp?action=restart|start|stop
POST /api/v1/cluster/<cluster-node-id>/node/services/snmp?action=restart|start|stop

Update SNMP service properties


Update SNMP service properties.
PUT /api/v1/node/services/snmp
PUT /api/v1/transport-nodes/<transport-node-id>/node/services/snmp
PUT /api/v1/cluster/<cluster-node-id>/node/services/snmp

Read SNMP service status


GET /api/v1/node/services/snmp/status
GET /api/v1/transport-nodes/<transport-node-id>/node/services/snmp/status
GET /api/v1/cluster/<cluster-node-id>/node/services/snmp/status

Read SNMP V3 Engine ID


GET /api/v1/node/services/snmp/v3-engine-id
GET /api/v1/transport-nodes/<transport-node-id>/node/services/snmp/v3-engine-id
GET /api/v1/cluster/<cluster-node-id>/node/services/snmp/v3-engine-id

Update SNMP V3 Engine ID


PUT /api/v1/node/services/snmp/v3-engine-id
PUT /api/v1/transport-nodes/<transport-node-id>/node/services/snmp/v3-engine-id
PUT /api/v1/cluster/<cluster-node-id>/node/services/snmp/v3-engine-id

Read Spark service properties


GET /api/v1/node/services/spark
GET /api/v1/transport-nodes/<transport-node-id>/node/services/spark
GET /api/v1/cluster/<cluster-node-id>/node/services/spark

Restart, start or stop the Spark service


POST /api/v1/node/services/spark?action=restart|start|stop
POST /api/v1/transport-nodes/<transport-node-id>/node/services/spark?action=restart|start|stop
POST /api/v1/cluster/<cluster-node-id>/node/services/spark?action=restart|start|stop

Read SparkJobScheduler service properties


GET /api/v1/node/services/spark-job-scheduler
GET /api/v1/transport-nodes/<transport-node-id>/node/services/spark-job-scheduler
GET /api/v1/cluster/<cluster-node-id>/node/services/spark-job-scheduler

Restart, start or stop the SparkJobScheduler service


POST /api/v1/node/services/spark-job-scheduler?action=restart|start|stop
POST /api/v1/transport-nodes/<transport-node-id>/node/services/spark-job-scheduler?action=restart|start|stop
POST /api/v1/cluster/<cluster-node-id>/node/services/spark-job-scheduler?action=restart|start|stop

Read SparkJobScheduler service status


GET /api/v1/node/services/spark-job-scheduler/status
GET /api/v1/transport-nodes/<transport-node-id>/node/services/spark-job-scheduler/status
GET /api/v1/cluster/<cluster-node-id>/node/services/spark-job-scheduler/status

Read Spark service status


GET /api/v1/node/services/spark/status
GET /api/v1/transport-nodes/<transport-node-id>/node/services/spark/status
GET /api/v1/cluster/<cluster-node-id>/node/services/spark/status

Read ssh service properties


GET /api/v1/node/services/ssh
GET /api/v1/transport-nodes/<transport-node-id>/node/services/ssh
GET /api/v1/cluster/<cluster-node-id>/node/services/ssh

Restart, start or stop the ssh service


POST /api/v1/node/services/ssh?action=start|stop|restart
POST /api/v1/transport-nodes/<transport-node-id>/node/services/ssh?action=start|stop|restart
POST /api/v1/cluster/<cluster-node-id>/node/services/ssh?action=start|stop|restart

Remove a host's fingerprint from known hosts file


POST /api/v1/node/services/ssh?action=remove_host_fingerprint
POST /api/v1/transport-nodes/<transport-node-id>/node/services/ssh?action=remove_host_fingerprint
POST /api/v1/cluster/<cluster-node-id>/node/services/ssh?action=remove_host_fingerprint

Update ssh service properties


Update ssh service properties. If the start_on_boot property is updated to true, existing ssh sessions if any are stopped and the ssh service is restarted.
PUT /api/v1/node/services/ssh
PUT /api/v1/transport-nodes/<transport-node-id>/node/services/ssh
PUT /api/v1/cluster/<cluster-node-id>/node/services/ssh

Restart, start or stop the ssh service


POST /api/v1/node/services/ssh/notify_mpa?action=start|stop|restart
POST /api/v1/transport-nodes/<transport-node-id>/node/services/ssh/notify_mpa?action=start|stop|restart
POST /api/v1/cluster/<cluster-node-id>/node/services/ssh/notify_mpa?action=start|stop|restart

Read ssh service status


GET /api/v1/node/services/ssh/status
GET /api/v1/transport-nodes/<transport-node-id>/node/services/ssh/status
GET /api/v1/cluster/<cluster-node-id>/node/services/ssh/status

Read syslog service properties


GET /api/v1/node/services/syslog
GET /api/v1/transport-nodes/<transport-node-id>/node/services/syslog
GET /api/v1/cluster/<cluster-node-id>/node/services/syslog

Restart, start or stop the syslog service


POST /api/v1/node/services/syslog?action=restart|start|stop
POST /api/v1/transport-nodes/<transport-node-id>/node/services/syslog?action=restart|start|stop
POST /api/v1/cluster/<cluster-node-id>/node/services/syslog?action=restart|start|stop

Delete all node syslog exporters


Removes all syslog exporter rules.
DELETE /api/v1/node/services/syslog/exporters
DELETE /api/v1/transport-nodes/<transport-node-id>/node/services/syslog/exporters
DELETE /api/v1/cluster/<cluster-node-id>/node/services/syslog/exporters

List node syslog exporters


Returns the collection of registered syslog exporter rules, if any. The
rules specify the collector IP address and port, and the protocol to use.
GET /api/v1/node/services/syslog/exporters
GET /api/v1/transport-nodes/<transport-node-id>/node/services/syslog/exporters
GET /api/v1/cluster/<cluster-node-id>/node/services/syslog/exporters

Verify node syslog exporter


Collect iptables rules needed for all existing syslog exporters and verify
if the existing iptables rules are the same. If not, remove the stale rules
and add the new rules to make sure all exporters work properly.
POST /api/v1/node/services/syslog/exporters?action=verify
POST /api/v1/transport-nodes/<transport-node-id>/node/services/syslog/exporters?action=verify
POST /api/v1/cluster/<cluster-node-id>/node/services/syslog/exporters?action=verify

Add node syslog exporter


Adds a rule for exporting syslog information to a specified server. The
required parameters are the rule name (exporter_name); severity level
(emerg, alert, crit, and so on); transmission protocol (TCP or UDP); and
server IP address or hostname. The optional parameters are the syslog port
number, which can be 1 through 65,535 (514, by default); facility level to
use when logging messages to syslog (kern, user, mail, and so on); and
message IDs (msgids), which identify the types of messages to export.
POST /api/v1/node/services/syslog/exporters
POST /api/v1/transport-nodes/<transport-node-id>/node/services/syslog/exporters
POST /api/v1/cluster/<cluster-node-id>/node/services/syslog/exporters

Delete node syslog exporter


Removes a specified rule from the collection of syslog exporter rules.
DELETE /api/v1/node/services/syslog/exporters/<exporter-name>
DELETE /api/v1/transport-nodes/<transport-node-id>/node/services/syslog/exporters/<exporter-name>
DELETE /api/v1/cluster/<cluster-node-id>/node/services/syslog/exporters/<exporter-name>

Read node syslog exporter


Returns information about a specific syslog collection point.
GET /api/v1/node/services/syslog/exporters/<exporter-name>
GET /api/v1/transport-nodes/<transport-node-id>/node/services/syslog/exporters/<exporter-name>
GET /api/v1/cluster/<cluster-node-id>/node/services/syslog/exporters/<exporter-name>

Read syslog service status


GET /api/v1/node/services/syslog/status
GET /api/v1/transport-nodes/<transport-node-id>/node/services/syslog/status
GET /api/v1/cluster/<cluster-node-id>/node/services/syslog/status

Read Telemetry service properties


GET /api/v1/node/services/telemetry
GET /api/v1/transport-nodes/<transport-node-id>/node/services/telemetry
GET /api/v1/cluster/<cluster-node-id>/node/services/telemetry

Restart, start or stop Telemetry service


POST /api/v1/node/services/telemetry?action=restart|start|stop
POST /api/v1/transport-nodes/<transport-node-id>/node/services/telemetry?action=restart|start|stop
POST /api/v1/cluster/<cluster-node-id>/node/services/telemetry?action=restart|start|stop

Read Telemetry service status


GET /api/v1/node/services/telemetry/status
GET /api/v1/transport-nodes/<transport-node-id>/node/services/telemetry/status
GET /api/v1/cluster/<cluster-node-id>/node/services/telemetry/status

Read ui service properties


GET /api/v1/node/services/ui-service
GET /api/v1/transport-nodes/<transport-node-id>/node/services/ui-service
GET /api/v1/cluster/<cluster-node-id>/node/services/ui-service

Restart, Start and Stop the ui service


POST /api/v1/node/services/ui-service?action=restart|start|stop
POST /api/v1/transport-nodes/<transport-node-id>/node/services/ui-service?action=restart|start|stop
POST /api/v1/cluster/<cluster-node-id>/node/services/ui-service?action=restart|start|stop

Read ui service status


GET /api/v1/node/services/ui-service/status
GET /api/v1/transport-nodes/<transport-node-id>/node/services/ui-service/status
GET /api/v1/cluster/<cluster-node-id>/node/services/ui-service/status

Read Zookeeper service properties


GET /api/v1/node/services/zookeeper
GET /api/v1/transport-nodes/<transport-node-id>/node/services/zookeeper
GET /api/v1/cluster/<cluster-node-id>/node/services/zookeeper

Restart, start or stop the Zookeeper service


POST /api/v1/node/services/zookeeper?action=restart|start|stop
POST /api/v1/transport-nodes/<transport-node-id>/node/services/zookeeper?action=restart|start|stop
POST /api/v1/cluster/<cluster-node-id>/node/services/zookeeper?action=restart|start|stop

Read Zookeeper service status


GET /api/v1/node/services/zookeeper/status
GET /api/v1/transport-nodes/<transport-node-id>/node/services/zookeeper/status
GET /api/v1/cluster/<cluster-node-id>/node/services/zookeeper/status

Read node status


Returns information about the node appliance's file system, CPU,
memory, disk usage, and uptime.
GET /api/v1/node/status
GET /api/v1/transport-nodes/<transport-node-id>/node/status
GET /api/v1/cluster/<cluster-node-id>/node/status

Update node status


Clear node bootup status
POST /api/v1/node/status?action=clear_bootup_error
POST /api/v1/transport-nodes/<transport-node-id>/node/status?action=clear_bootup_error
POST /api/v1/cluster/<cluster-node-id>/node/status?action=clear_bootup_error

Read node support bundle


GET /api/v1/node/support-bundle
GET /api/v1/transport-nodes/<transport-node-id>/node/support-bundle
GET /api/v1/cluster/<cluster-node-id>/node/support-bundle

List appliance management tasks


GET /api/v1/node/tasks
GET /api/v1/transport-nodes/<transport-node-id>/node/tasks
GET /api/v1/cluster/<cluster-node-id>/node/tasks

Delete task


DELETE /api/v1/node/tasks/<task-id>
DELETE /api/v1/transport-nodes/<transport-node-id>/node/tasks/<task-id>
DELETE /api/v1/cluster/<cluster-node-id>/node/tasks/<task-id>

Read task properties


GET /api/v1/node/tasks/<task-id>
GET /api/v1/transport-nodes/<transport-node-id>/node/tasks/<task-id>
GET /api/v1/cluster/<cluster-node-id>/node/tasks/<task-id>

Cancel specified task


POST /api/v1/node/tasks/<task-id>?action=cancel
POST /api/v1/transport-nodes/<transport-node-id>/node/tasks/<task-id>?action=cancel
POST /api/v1/cluster/<cluster-node-id>/node/tasks/<task-id>?action=cancel

Read asynchronous task response


GET /api/v1/node/tasks/<task-id>/response
GET /api/v1/transport-nodes/<transport-node-id>/node/tasks/<task-id>/response
GET /api/v1/cluster/<cluster-node-id>/node/tasks/<task-id>/response

List node users


Returns the list of users configued to log in to the NSX appliance.
GET /api/v1/node/users
GET /api/v1/transport-nodes/<transport-node-id>/node/users
GET /api/v1/cluster/<cluster-node-id>/node/users

Reset a user's own password. Requires current password


Enables a user to reset their own password.
POST /api/v1/node/users?action=reset_own_password
POST /api/v1/transport-nodes/<transport-node-id>/node/users?action=reset_own_password
POST /api/v1/cluster/<cluster-node-id>/node/users?action=reset_own_password

Read node user


Returns information about a specified user who is configued to log in to the
NSX appliance. The valid user IDs are: 0, 10000, 10002.
GET /api/v1/node/users/<userid>
GET /api/v1/transport-nodes/<transport-node-id>/node/users/<userid>
GET /api/v1/cluster/<cluster-node-id>/node/users/<userid>

Reset a user's password without requiring their current password


Unlike the PUT version of this call (PUT /node/users/), this API
does not require that the current password for the user be provided. The
account of the target user must be "ACTIVE" for the call to succeed.
This API only supports user ID 10002.
POST /api/v1/node/users/<userid>?action=reset_password
POST /api/v1/transport-nodes/<transport-node-id>/node/users/<userid>?action=reset_password
POST /api/v1/cluster/<cluster-node-id>/node/users/<userid>?action=reset_password

Update node user


Updates attributes of an existing NSX appliance user. This method
cannot be used to add a new user. Modifiable attributes include the
username, full name of the user, and password. If you specify a password in
a PUT request, it is not returned in the response. Nor is it returned in a
GET request.
The specified password does not meet the following complexity requirements:
- minimum 12 characters in length
- minimum 1 uppercase character
- minimum 1 lowercase character
- minimum 1 numeric character
- minimum 1 special character
- minimum 5 unique characters
- default password complexity rules as enforced by the Linux PAM module
The valid user IDs are: 0, 10000, 10002.
Note that invoking this API does not update any user-related properties of
existing objects in the system and does not modify the username field in existing
audit log entries.
PUT /api/v1/node/users/<userid>
PUT /api/v1/transport-nodes/<transport-node-id>/node/users/<userid>
PUT /api/v1/cluster/<cluster-node-id>/node/users/<userid>

List SSH keys from authorized_keys file for node user


Returns a list of all SSH keys from authorized_keys file for node user
GET /api/v1/node/users/<userid>/ssh-keys
GET /api/v1/transport-nodes/<transport-node-id>/node/users/<userid>/ssh-keys
GET /api/v1/cluster/<cluster-node-id>/node/users/<userid>/ssh-keys

Remove SSH public key from authorized_keys file for node user


POST /api/v1/node/users/<userid>/ssh-keys?action=remove_ssh_key
POST /api/v1/transport-nodes/<transport-node-id>/node/users/<userid>/ssh-keys?action=remove_ssh_key
POST /api/v1/cluster/<cluster-node-id>/node/users/<userid>/ssh-keys?action=remove_ssh_key

Add SSH public key to authorized_keys file for node user


POST /api/v1/node/users/<userid>/ssh-keys?action=add_ssh_key
POST /api/v1/transport-nodes/<transport-node-id>/node/users/<userid>/ssh-keys?action=add_ssh_key
POST /api/v1/cluster/<cluster-node-id>/node/users/<userid>/ssh-keys?action=add_ssh_key

Read node version


GET /api/v1/node/version
GET /api/v1/transport-nodes/<transport-node-id>/node/version
GET /api/v1/cluster/<cluster-node-id>/node/version

Get PCG registration payload


GET /api/v1/pcg-registration-payload

Returns list of configured IP address blocks.


Returns information about configured IP address blocks. Information includes
the id, display name, description & CIDR of IP address blocks
GET /api/v1/pools/ip-blocks

Create a new IP address block.


Creates a new IPv4 address block using the specified cidr. cidr is a required
parameter. display_name & description are optional parameters
POST /api/v1/pools/ip-blocks

Delete an IP Address Block


Deletes the IP address block with specified id if it exists. IP
block cannot be deleted if there are allocated subnets from the block.
DELETE /api/v1/pools/ip-blocks/<block-id>

Get IP address block information.


Returns information about the IP address block with specified id.
Information includes id, display_name, description & cidr.
GET /api/v1/pools/ip-blocks/<block-id>

Update an IP Address Block


Modifies the IP address block with specifed id. display_name, description
and cidr are parameters that can be modified. If a new cidr is specified,
it should contain all existing subnets in the IP block. Returns a conflict error
if the IP address block cidr can not be modified due to the presence of
subnets that it contains. Eg: If the IP block contains a subnet 192.168.0.1/24
and we try to change the IP block cidr to 10.1.0.1/16, it results in a conflict.
PUT /api/v1/pools/ip-blocks/<block-id>

List IP Pools


Returns information about the configured IP address pools. Information
includes the display name and description of the pool and the details of
each of the subnets in the pool, including the DNS servers, allocation
ranges, gateway, and CIDR subnet address.
GET /api/v1/pools/ip-pools

Create an IP Pool


Creates a new IPv4 or IPv6 address pool. Required parameters are
allocation_ranges and cidr. Optional parameters are display_name,
description, dns_nameservers, dns_suffix, and gateway_ip.
POST /api/v1/pools/ip-pools

Delete an IP Pool


Deletes the specified IP address pool. By default, if the IpPool is used in other configurations (such as transport node template), it won't be deleted. In such situations, pass "force=true" as query param to force delete the IpPool
DELETE /api/v1/pools/ip-pools/<pool-id>

Read IP Pool


Returns information about the specified IP address pool.
GET /api/v1/pools/ip-pools/<pool-id>

Allocate or Release an IP Address from a Pool


Allocates or releases an IP address from the specified IP pool. To allocate
an address, include ?action=ALLOCATE in the request and "allocation_id":null
in the request body. When the request is successful, the response is
"allocation_id": "", where is an IP address from
the specified pool. To release an IP address (return it back to the pool),
include ?action=RELEASE in the request and "allocation_id": in
the request body, where is the address to be released. When the
request is successful, the response is NULL. Tags, display_name and description
attributes are not supported for AllocationIpAddress in this release.
POST /api/v1/pools/ip-pools/<pool-id>

Update an IP Pool


Modifies the specified IP address pool. Modifiable parameters include the
description, display_name, and all subnet information.
PUT /api/v1/pools/ip-pools/<pool-id>

List IP Pool Allocations


Returns information about which addresses have been allocated from a
specified IP address pool.
GET /api/v1/pools/ip-pools/<pool-id>/allocations

List subnets within an IP block


Returns information about all subnets present within an IP address
block. Information includes subnet's id, display_name, description, cidr and
allocation ranges.
GET /api/v1/pools/ip-subnets

Create subnet of specified size within an IP block


Carves out a subnet of requested size from the specified IP block. The "size"
parameter and the "block_id " are the requireds field while invoking this API.
If the IP block has sufficient resources/space to allocate a subnet of specified size,
the response will contain all the details of the newly created subnet including the
display_name, description, cidr & allocation_ranges. Returns a conflict error
if the IP block does not have enough resources/space to allocate a subnet of
the requested size.
POST /api/v1/pools/ip-subnets

Delete subnet within an IP block


Deletes a subnet with specified id within a given IP address block.
Deletion is allowed only when there are no allocated IP addresses
from that subnet.
DELETE /api/v1/pools/ip-subnets/<subnet-id>

Get the subnet within an IP block


Returns information about the subnet with specified id within a given
IP address block. Information includes display_name, description, cidr and
allocation_ranges.
GET /api/v1/pools/ip-subnets/<subnet-id>

Allocate or Release an IP Address from a Ip Subnet


Allocates or releases an IP address from the specified IP subnet. To allocate
an address, include ?action=ALLOCATE in the request and a "{}"
in the request body. When the request is successful, the response is
"allocation_id": "", where is an IP address from
the specified pool. To release an IP address (return it back to the pool),
include ?action=RELEASE in the request and "allocation_id": in
the request body, where is the address to be released. When the
request is successful, the response is NULL.
POST /api/v1/pools/ip-subnets/<subnet-id>

List MAC Pools


Returns a list of all the MAC pools
GET /api/v1/pools/mac-pools

Read MAC Pool


Returns information about the specified MAC pool.
GET /api/v1/pools/mac-pools/<pool-id>

List VNI Pools


Returns information about the default and configured virtual
network identifier (VNI) pools for use when building logical network
segments. Each virtual network has a unique ID called a VNI. Instead
of creating a new VNI each time you need a new logical switch, you
can instead allocate a VNI from a VNI pool. VNI pools are sometimes
called segment ID pools. Each VNI pool has a range of usable VNIs. By
default, there is one pool with two ranges [5000, 65535] and [65536,
75000]. To create multiple smaller pools, specify a smaller range for
each pool such as 75001-75100 and 75101-75200. The VNI range determines
the maximum number of logical switches that can be created in each
network segment.
GET /api/v1/pools/vni-pools

Create a new VNI Pool.


Creates a new VNI pool using the specified VNI pool range. The range
should be non-overlapping with an existing range. If the range in
payload is present or overlaps with an existing range, return code 400
with bad request and an error message is returned mentioning that the
given range overlaps with an existing range.
POST /api/v1/pools/vni-pools

Delete a VNI Pool


Deletes the given VNI pool.
DELETE /api/v1/pools/vni-pools/<pool-id>

Read VNI Pool


Returns information about the specified virtual network identifier (VNI) pool.
GET /api/v1/pools/vni-pools/<pool-id>

Update a VNI Pool


Updates the specified VNI pool. Modifiable parameters include description, display_name and ranges.
Ranges can be added, modified or deleted. Overlapping ranges are not allowed.
Only range end can be modified for any existing range.
Range shrinking or deletion is not allowed if there are any allocated VNIs.
PUT /api/v1/pools/vni-pools/<pool-id>

List virtual tunnel endpoint Label Pools


Returns a list of all virtual tunnel endpoint label pools
GET /api/v1/pools/vtep-label-pools

Read a virtual tunnel endpoint label pool


Returns information about the specified virtual tunnel endpoint label pool.
GET /api/v1/pools/vtep-label-pools/<pool-id>

Gets the realization state barrier configuration


Returns the current barrier configuration
GET /api/v1/realization-state-barrier/config

Updates the barrier configuration


Updates the barrier configuration having interval set in milliseconds
The new interval that automatically increments the global realization number
PUT /api/v1/realization-state-barrier/config

Gets the current barrier number


Returns the current global realization barrier number for NSX.
This method has been deprecated. To track realization state, use
X-NSX-REQUESTID request header instead.
GET /api/v1/realization-state-barrier/current (Deprecated)

Increments the barrier count by 1


Increment the current barrier number by 1 for NSX.
This method has been deprecated. To track realization state, use
X-NSX-REQUESTID request header instead.
POST /api/v1/realization-state-barrier/current?action=increment (Deprecated)

Get list of bundle-ids which are available in repository or in-progress


Get list of bundle-ids which are available in repository or in-progress
GET /api/v1/repository/bundles

Upload bundle


Upload the bundle. This call returns after upload is completed.
You can check bundle processing status periodically by retrieving
bundle upload-status to find out if the upload and processing is completed.
POST /api/v1/repository/bundles?action=upload

Upload bundle using remote file


Upload the bundle from remote bundle URL. The call returns after fetch is initiated.
Check status by periodically retrieving bundle upload status
using GET /repository/bundles//upload-status.
The upload is complete when the status is SUCCESS.
POST /api/v1/repository/bundles

Cancel bundle upload


Cancel upload of bundle. This API works only when bundle upload is
in-progress and will not work during post-processing of bundle. If
bundle upload is in-progress, then the API call returns http OK response
after cancelling the upload and deleting partially uploaded bundle.
POST /api/v1/repository/bundles/<bundle-id>?action=cancel_upload

Get bundle upload status


Get uploaded bundle upload status
GET /api/v1/repository/bundles/<bundle-id>/upload-status

Get information of the OVF which will be getting deployed.


Get information of the OVF for specified product which is
present in repository and will be used to deploy new VM.
GET /api/v1/repository/bundles/ovf-deploy-info

Checks bundle upload permissions


Checks whether bundle upload is allowed on given node for given product.
There are different kinds of checks for different products. Some of the
checks for Intelligence product are as follows:
1. Is bundle upload-allowed on given node
2. Is bundle upload already in-progress
3. Is Intelliegnce node deployment in-progress
4. Is Intelliegnce node upgrade in-progress
GET /api/v1/repository/bundles/upload-allowed

Get information about all tasks


GET /api/v1/tasks

Get information about the specified task


GET /api/v1/tasks/<task-id>

Get the response of a task


GET /api/v1/tasks/<task-id>/response

List Transport Node collections


Returns all Transport Node collections
GET /api/v1/transport-node-collections

Create transport node collection by attaching Transport Node Profile to cluster.


When transport node collection is created the hosts which are part
of compute collection will be prepared automatically i.e. NSX Manager
attempts to install the NSX components on hosts. Transport nodes for these
hosts are created using the configuration specified in transport node
profile.
POST /api/v1/transport-node-collections

Detach transport node profile from compute collection.


By deleting transport node collection, we are detaching the transport node
profile(TNP) from the compute collection. It has no effect on existing
transport nodes. However, new hosts added to the compute collection will no
longer be automatically converted to NSX transport node.
Detaching TNP from compute collection does not delete TNP.
DELETE /api/v1/transport-node-collections/<transport-node-collection-id>

Get Transport Node collection by id


Returns transport node collection by id
GET /api/v1/transport-node-collections/<transport-node-collection-id>

Retry the process on applying transport node profile


This API is relevant for compute collection on which vLCM is enabled. This API shpuld be invoked to retry the realization of transport node profile on the compute collection. This is useful when profile realization had failed because of error in vLCM. This API has no effect if vLCM is not enabled on the computer collection.
POST /api/v1/transport-node-collections/<transport-node-collection-id>?action=retry_profile_realization

Update Transport Node collection


Attach different transport node profile to compute collection by updating
transport node collection.
PUT /api/v1/transport-node-collections/<transport-node-collection-id>

Get Transport Node collection application state


Returns the state of transport node collection based on the states of
transport nodes of the hosts which are part of compute collection.
GET /api/v1/transport-node-collections/<transport-node-collection-id>/state

List Transport Nodes


Returns information about all transport node profiles.
GET /api/v1/transport-node-profiles

Create a Transport Node Profile


Transport node profile captures the configuration needed to create
a transport node. A transport node profile can be attached to
compute collections for automatic TN creation of member hosts.
POST /api/v1/transport-node-profiles

Delete a Transport Node Profile


Deletes the specified transport node profile. A transport node profile
can be deleted only when it is not attached to any compute collection.
DELETE /api/v1/transport-node-profiles/<transport-node-profile-id>

Get a Transport Node


Returns information about a specified transport node profile.
GET /api/v1/transport-node-profiles/<transport-node-profile-id>

Update a Transport Node Profile


When configurations of a transport node profile(TNP) is updated, all the
transport nodes in all the compute collections to which this TNP is attached
are updated to reflect the updated configuration.
PUT /api/v1/transport-node-profiles/<transport-node-profile-id>

List Transport Nodes


Returns information about all transport nodes along with underlying host or
edge details. A transport node is a host or edge that contains hostswitches.
A hostswitch can have virtual machines connected to them.

Because each transport node has hostswitches, transport nodes can also have
virtual tunnel endpoints, which means that they can be part of the overlay.
GET /api/v1/transport-nodes

Create a Transport Node


Transport nodes are hypervisor hosts and NSX Edges that will participate
in an NSX-T overlay. For a hypervisor host, this means that it hosts
VMs that will communicate over NSX-T logical switches. For NSX Edges,
this means that it will have logical router uplinks and downlinks.

This API creates transport node for a host node (hypervisor) or edge node
(router) in the transport network.

When you run this command for a host, NSX Manager attempts to install the
NSX kernel modules, which are packaged as VIB, RPM, or DEB files. For the
installation to succeed, you must provide the host login credentials and the
host thumbprint.

To get the ESXi host thumbprint, SSH to the host and run the
openssl x509 -in /etc/vmware/ssl/rui.crt -fingerprint -sha256 -noout
command.

To generate host key thumbprint using SHA-256 algorithm please follow the
steps below.

Log into the host, making sure that the connection is not vulnerable to a
man in the middle attack. Check whether a public key already exists.
Host public key is generally located at '/etc/ssh/ssh_host_rsa_key.pub'.
If the key is not present then generate a new key by running the following
command and follow the instructions.

ssh-keygen -t rsa

Now generate a SHA256 hash of the key using the following command. Please
make sure to pass the appropriate file name if the public key is stored with
a different file name other than the default 'id_rsa.pub'.

awk '{print $2}' id_rsa.pub | base64 -d | sha256sum -b | sed 's/ .*$//' | xxd -r -p | base64
This api is deprecated as part of FN+TN unification. Please use Transport Node API
to install NSX components on a node.

Additional documentation on creating a transport node can be found
in the NSX-T Installation Guide.

In order for the transport node to forward packets,
the host_switch_spec property must be specified.

Host switches (called bridges in OVS on KVM hypervisors) are the
individual switches within the host virtual switch. Virtual machines
are connected to the host switches.

When creating a transport node, you need to specify if the host switches
are already manually preconfigured on the node, or if NSX should create
and manage the host switches. You specify this choice by the type
of host switches you pass in the host_switch_spec property of the
TransportNode request payload.

For a KVM host, you can preconfigure the host switch, or you can have
NSX Manager perform the configuration. For an ESXi host or NSX Edge
node, NSX Manager always configures the host switch.

To preconfigure the host switches on a KVM host, pass an array
of PreconfiguredHostSwitchSpec objects that describes those host
switches. In the current NSX-T release, only one prefonfigured host
switch can be specified. See the PreconfiguredHostSwitchSpec schema
definition for documentation on the properties that must be provided.
Preconfigured host switches are only supported on KVM hosts, not on
ESXi hosts or NSX Edge nodes.

To allow NSX to manage the host switch configuration on KVM hosts,
ESXi hosts, or NSX Edge nodes, pass an array of StandardHostSwitchSpec
objects in the host_switch_spec property, and NSX will automatically
create host switches with the properties you provide. In the current
NSX-T release, up to 16 host switches can be automatically managed.
See the StandardHostSwitchSpec schema definition for documentation on
the properties that must be provided.

Note: Previous versions of NSX-T also used a property named
transport_zone_endpoints at TransportNode level. This property is
deprecated which creates some combinations of new client along with
old client payloads. Examples [1] & [2] show old/existing client
request and response by populating transport_zone_endpoints property
at TransportNode level. Example [3] shows TransportNode creation
request/response by populating transport_zone_endpoints property
at StandardHostSwitch level and other new properties.

The request should either provide node_deployement_info or node_id.

If the host node (hypervisor) or edge node (router) is already added in
system then it can be converted to transport node by providing node_id in
request.

If host node (hypervisor) or edge node (router) is not already present in
system then information should be provided under node_deployment_info.
POST /api/v1/transport-nodes

Paginated list of BGP Neighbors on edge transport node


Paginated list of BGP Neighbors on edge transport node.
GET /api/v1/transport-nodes/<edge-node-id>/inter-site/bgp/neighbors

Get BGP neighbor advertised routes on edge transport node


Returns routes advertised by BGP neighbor from the given edge transport node.
It always returns realtime response.
GET /api/v1/transport-nodes/<edge-node-id>/inter-site/bgp/neighbors/<neighbor-id>/advertised-routes

Get BGP neighbor learned routes on edge transport node


Returns routes learned by BGP neighbor from the given edge transport node.
It always returns realtime response.
GET /api/v1/transport-nodes/<edge-node-id>/inter-site/bgp/neighbors/<neighbor-id>/routes

Get inter-site BGP summary of edge node


Returns BGP summary for all configured neighbors in tunnel VRF
on the given egde node. It always returns realtime response.
GET /api/v1/transport-nodes/<edge-node-id>/inter-site/bgp/summary

Get inter-site statistics of edge node


Returns RTEP to RTEP tunnel port statistics of the given edge node.
It always returns realtime response.
GET /api/v1/transport-nodes/<edge-node-id>/inter-site/statistics

Redeploys a new node that replaces the specified edge node.


Redeploys an edge node at NSX Manager that replaces the edge node with
identifier . If NSX Manager can access the specified edge node,
then the node is put into maintenance mode and then the associated VM is
deleted. This is a means to reset all configuration on the edge node.
The communication channel between NSX Manager and edge is established after
this operation.
POST /api/v1/transport-nodes/<node-id>?action=redeploy

Get the module details of a transport node


GET /api/v1/transport-nodes/<node-id>/modules

Get high-level summary of a transport node


GET /api/v1/transport-nodes/<node-id>/pnic-bond-status

Read status of all transport nodes with tunnel connections to transport node


GET /api/v1/transport-nodes/<node-id>/remote-transport-node-status

Read status of a transport node


GET /api/v1/transport-nodes/<node-id>/status

List of tunnels


GET /api/v1/transport-nodes/<node-id>/tunnels

Tunnel properties


GET /api/v1/transport-nodes/<node-id>/tunnels/<tunnel-name>

Invoke DELETE request on target transport node


DELETE /api/v1/transport-nodes/<target-node-id>/<target-uri>

Invoke GET request on target transport node


GET /api/v1/transport-nodes/<target-node-id>/<target-uri>

Invoke POST request on target transport node


POST /api/v1/transport-nodes/<target-node-id>/<target-uri>

Invoke PUT request on target transport node


PUT /api/v1/transport-nodes/<target-node-id>/<target-uri>

Delete a Transport Node


Deletes the specified transport node. Query param force can be used to
force delete the host nodes. Force deletion of edge and public cloud
gateway nodes is not supported.

It also removes the specified node (host or edge) from system.
If unprepare_host option is set to false, then host will be deleted
without uninstalling the NSX components from the host.
DELETE /api/v1/transport-nodes/<transport-node-id>

Get a Transport Node


Returns information about a specified transport node.
GET /api/v1/transport-nodes/<transport-node-id>

Apply cluster level Transport Node Profile on overridden host


A host can be overridden to have different configuration than Transport
Node Profile(TNP) on cluster. This action will restore such overridden host
back to cluster level TNP.

This API can be used in other case. When TNP is applied to a cluster,
if any validation fails (e.g. VMs running on host) then existing transport
node (TN) is not updated. In that case after the issue is resolved manually
(e.g. VMs powered off), you can call this API to update TN as per cluster
level TNP.
POST /api/v1/transport-nodes/<transport-node-id>?action=restore_cluster_config

Enable flow cache for an edge transport node


Enable flow cache for edge transport node.
Caution: This involves restart of the edge
dataplane and hence may lead to network disruption.
POST /api/v1/transport-nodes/<transport-node-id>?action=enable_flow_cache

Refresh the node configuration for the Edge node.


The API is applicable for Edge transport nodes. If you update the VM
configuration and find a discrepancy in VM configuration at NSX Manager,
then use this API to refresh configuration at NSX Manager.
It refreshes the VM configuration from sources external to MP. Sources
include vSphere Server and the edge node. After this action, the API
GET api/v1/transport-nodes will show refreshed data.
POST /api/v1/transport-nodes/<transport-node-id>?action=refresh_node_configuration&resource_type=EdgeNode

Restart the inventory sync for the node if it is paused currently.


Restart the inventory sync for the node if it is currently internally paused.
After this action the next inventory sync coming from the node is processed.
POST /api/v1/transport-nodes/<transport-node-id>?action=restart_inventory_sync

Disable flow cache for an edge transport node


Disable flow cache for edge transport node.
Caution: This involves restart of the edge
dataplane and hence may lead to network disruption.
POST /api/v1/transport-nodes/<transport-node-id>?action=disable_flow_cache

Update a Transport Node


Modifies the transport node information. The host_switch_name field
must match the host_switch_name value specified in the transport zone
(API: transport-zones). You must create the associated uplink profile
(API: host-switch-profiles) before you can specify an uplink_name here.
If the host is an ESX and has only one physical NIC being used by a vSphere
standard switch, TransportNodeUpdateParameters should be used to migrate
the management interface and the physical NIC into a logical switch that
is in a transport zone this transport node will join or has already joined.
If the migration is already done, TransportNodeUpdateParameters can also be
used to migrate the management interface and the physical NIC back to a
vSphere standard switch.
In other cases, the TransportNodeUpdateParameters should NOT be used.
When updating transport node you should follow pattern where you should
fetch the existing transport node and then only modify the required
properties keeping other properties as is.

It also modifies attributes of node (host or edge).

Note: Previous versions of NSX-T also used a property named
transport_zone_endpoints at TransportNode level. This property is
deprecated which creates some combinations of new client along with
old client payloads. Examples [1] shows old/existing client
request and response by populating transport_zone_endpoints property
at TransportNode level. Example [2] shows TransportNode updating
TransportNode from exmaple [1] request/response by adding a
new StandardHostSwitch by populating transport_zone_endpoints at
StandardHostSwitch level. TransportNode level transport_zone_endpoints
will ONLY have TransportZoneEndpoints that were originally specified
here during create/update operation and does not include
TransportZoneEndpoints that were directly specified at
StandardHostSwitch level.
PUT /api/v1/transport-nodes/<transport-node-id>

Return the list of capabilities of transport node


Returns information about capabilities of transport host node. Edge nodes do not have capabilities.
GET /api/v1/transport-nodes/<transport-node-id>/capabilities

List the specified transport node's network interfaces


Returns the number of interfaces on the node and detailed
information about each interface. Interface information includes MTU,
broadcast and host IP addresses, link and admin status, MAC address, network
mask, and the IP configuration method (static or DHCP).
GET /api/v1/transport-nodes/<transport-node-id>/network/interfaces

Read the transport node's network interface


Returns detailed information about the specified interface. Interface
information includes MTU, broadcast and host IP addresses, link and admin
status, MAC address, network mask, and the IP configuration method (static
or DHCP).
GET /api/v1/transport-nodes/<transport-node-id>/network/interfaces/<interface-id>

Read the NSX Manager's Network Interface Statistics


On the specified interface, returns the number of received (rx), transmitted
(tx), and dropped packets; the number of bytes and errors received and
transmitted on the interface; and the number of detected collisions.
GET /api/v1/transport-nodes/<transport-node-id>/network/interfaces/<interface-id>/stats

Get a Transport Node's State


Returns information about the current state of the transport node
configuration and information about the associated hostswitch.
GET /api/v1/transport-nodes/<transport-node-id>/state

Resync a Transport Node


Resync the TransportNode configuration on a host.
It is similar to updating the TransportNode with existing configuration,
but force synce these configurations to the host (no backend optimizations).
POST /api/v1/transport-nodes/<transportnode-id>?action=resync_host_config

Update transport node maintenance mode


Put transport node into maintenance mode or exit from maintenance mode.
POST /api/v1/transport-nodes/<transportnode-id>

List transport nodes by realized state


Returns a list of transport node states that have realized state as provided
as query parameter
GET /api/v1/transport-nodes/state

Get high-level summary of all transport nodes. The service layer does not support source = realtime or cached.


GET /api/v1/transport-nodes/status

List Transport Zones


Returns information about configured transport zones. NSX requires at
least one transport zone. NSX uses transport zones to provide connectivity
based on the topology of the underlying network, trust zones, or
organizational separations. For example, you might have hypervisors that
use one network for management traffic and a different network for VM
traffic. This architecture would require two transport zones. The
combination of transport zones plus transport connectors enables NSX to
form tunnels between hypervisors. Transport zones define which interfaces
on the hypervisors can communicate with which other interfaces on other
hypervisors to establish overlay tunnels or provide connectivity to a VLAN.
A logical switch can be in one (and only one) transport zone. This means
that all of a switch's interfaces must be in the same transport zone.
However, each hypervisor virtual switch (OVS or VDS) has multiple
interfaces (connectors), and each connector can be attached to a different
logical switch. For example, on a single hypervisor with two connectors,
connector A can be attached to logical switch 1 in transport zone A, while
connector B is attached to logical switch 2 in transport zone B. In this
way, a single hypervisor can participate in multiple transport zones. The
API for creating a transport zone requires that a single host switch be
specified for each transport zone, and multiple transport zones can share
the same host switch.
GET /api/v1/transport-zones

Create a Transport Zone


Creates a new transport zone. The required parameters are host_switch_name
and transport_type (OVERLAY or VLAN). The optional parameters are
description and display_name.
POST /api/v1/transport-zones

Delete a Transport Zone


Deletes an existing transport zone.
DELETE /api/v1/transport-zones/<zone-id>

Get a Transport Zone


Returns information about a single transport zone.
GET /api/v1/transport-zones/<zone-id>

Update a Transport Zone


Updates an existing transport zone. Modifiable parameters are
is_default, description, and display_name. The
request must include the existing host_switch_name.
PUT /api/v1/transport-zones/<zone-id>

Get high-level summary of a transport zone


GET /api/v1/transport-zones/<zone-id>/status

Get a Transport Zone's Current Runtime Status Information


Returns information about a specified transport zone, including the number
of logical switches in the transport zone, number of logical spitch ports
assigned to the transport zone, and number of transport nodes in the
transport zone.
GET /api/v1/transport-zones/<zone-id>/summary

Read status of transport nodes in a transport zone


GET /api/v1/transport-zones/<zone-id>/transport-node-status

Creates a status report of transport nodes in a transport zone


You must provide the request header "Accept:application/octet-stream" when calling this API.
GET /api/v1/transport-zones/<zone-id>/transport-node-status-report

Get high-level summary of a transport zone. The service layer does not support source = realtime or cached.


GET /api/v1/transport-zones/status

Read status of all the transport nodes


GET /api/v1/transport-zones/transport-node-status

Creates a status report of transport nodes of all the transport zones


You must provide the request header "Accept:application/octet-stream" when calling this API.
GET /api/v1/transport-zones/transport-node-status-report

List transport zone profiles


Returns information about the configured transport zone profiles. Transport zone
profiles define networking policies for transport zones and transport zone endpoints.
GET /api/v1/transportzone-profiles

Create a transport zone Profile


Creates a transport zone profile. The resource_type is required.
POST /api/v1/transportzone-profiles

Delete a transport zone Profile


Deletes a specified transport zone profile.
DELETE /api/v1/transportzone-profiles/<transportzone-profile-id>

Get transport zone profile by identifier


Returns information about a specified transport zone profile.
GET /api/v1/transportzone-profiles/<transportzone-profile-id>

Update a transport zone profile


Modifies a specified transport zone profile. The body of the PUT request must include the resource_type.
PUT /api/v1/transportzone-profiles/<transportzone-profile-id>

Reset IPSec VPN session statistics


Reset IPSec VPN session statistics
POST /api/v1/vpn/ipsec/sessions/<sessionid>/statistics?action=reset