API Description | API Path |
---|---|
List All Logical PortsReturns information about all configured logical switch ports. Logical switch ports connect to VM virtual network interface cards (NICs). Each logical port is associated with one logical switch. |
GET /api/v1/logical-ports
|
Create a Logical PortCreates a new logical switch port. The required parameters are the associated logical_switch_id and admin_state (UP or DOWN). Optional parameters are the attachment and switching_profile_ids. If you don't specify switching_profile_ids, default switching profiles are assigned to the port. If you don't specify an attachment, the switch port remains empty. To configure an attachment, you must specify an id, and optionally you can specify an attachment_type (VIF or LOGICALROUTER). The attachment_type is VIF by default. |
POST /api/v1/logical-ports
|
Delete a Logical PortDeletes the specified logical switch port. By default, if logical port has attachments, or it is added to any NSGroup, the deletion will be failed. Option detach could be used for deleting logical port forcibly. |
DELETE /api/v1/logical-ports/<lport-id>
|
Get Information About a Logical PortReturns information about a specified logical port. |
GET /api/v1/logical-ports/<lport-id>
|
Update a Logical PortModifies an existing logical switch port. Parameters that can be modified include attachment_type (LOGICALROUTER, VIF), admin_state (UP or DOWN), attachment id and switching_profile_ids. You cannot modify the logical_switch_id. In other words, you cannot move an existing port from one switch to another switch. |
PUT /api/v1/logical-ports/<lport-id>
|
Get MAC table of a logical port with a given port id (lport-id)Returns MAC table of a specified logical port. If the target transport node id is not provided, the NSX manager will ask the controller for the transport node where the logical port is located. The query parameter "source=cached" is not supported. MAC table retrieval is not supported on logical ports that are attached to a logical router. |
GET /api/v1/logical-ports/<lport-id>/mac-table
|
Get MAC table of a logical port with a given port id (lport-id)Returns MAC table in CSV format of a specified logical port. If the target transport node id is not provided, the NSX manager will ask the controller for the transport node where the logical port is located. The query parameter "source=cached" is not supported. MAC table retrieval is not supported on logical ports that are attached to a logical router. |
GET /api/v1/logical-ports/<lport-id>/mac-table?format=csv
|
Get realized state & location of a logical portReturns transport node id for a specified logical port. Also returns information about all address bindings of the specified logical port. This includes address bindings discovered via various snooping methods like ARP snooping, DHCP snooping etc. and addressing bindings that are realized based on user configuration. |
GET /api/v1/logical-ports/<lport-id>/state
|
Get Statistics for Logical Port of a Given Port ID (lport-id)Returns statistics of a specified logical port. If the logical port is attached to a logical router port, query parameter "source=realtime" is not supported. |
GET /api/v1/logical-ports/<lport-id>/statistics
|
Get Operational Status for Logical Port of a Given Port ID (lport-id)Returns operational status of a specified logical port. |
GET /api/v1/logical-ports/<lport-id>/status
|
Get Operational Status Summary of All Logical Ports in the SystemReturns operational status of all logical ports. The query parameter "source=realtime" is not supported. Pagination is not supported for this API. The query parameters "cursor", "sort_ascending", "sort_by", "page_size" and "included_fields" will be ignored. |
GET /api/v1/logical-ports/status
|
List Switching ProfilesReturns information about the system-default and user-configured switching profiles. Each switching profile has a unique ID, a display name, and various other read-only and configurable properties. The default switching profiles are assigned automatically to each switch. |
GET /api/v1/switching-profiles
|
Create a Switching ProfileCreates a new, custom qos, port-mirroring, spoof-guard or port-security switching profile. You can override their default switching profile assignments by creating a new switching profile and assigning it to one or more logical switches. You cannot override the default ipfix or ip_discovery switching profiles. |
POST /api/v1/switching-profiles
|
Delete a Switching ProfileDeletes the specified switching profile. |
DELETE /api/v1/switching-profiles/<switching-profile-id>
|
Get Switching Profile by IDReturns information about a specified switching profile. |
GET /api/v1/switching-profiles/<switching-profile-id>
|
Update a Switching ProfileUpdates the user-configurable parameters of a switching profile. Only the qos, port-mirroring, spoof-guard and port-security switching profiles can be modified. You cannot modify the ipfix or ip-discovery switching profiles. |
PUT /api/v1/switching-profiles/<switching-profile-id>
|
Get Counts of Ports and Switches Using This Switching Profile |
GET /api/v1/switching-profiles/<switching-profile-id>/summary
|