System Administration > Configuration > Fabric > Nodes > Network Interfaces

Associated URIs:

API Description	API Path
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
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>