NSX-T Data Center REST API

Delete a Logical Switch (Deprecated)

Removes a logical switch from the associated overlay or VLAN transport
zone. By default, a logical switch cannot be deleted if there are logical
ports on the switch, or it is added to a NSGroup.
Cascade option can be used to delete all ports and the logical switch.
Detach option can be used to delete the logical switch forcibly. This api is now deprecated.
Please use new api - /infra/segments/<segment-id>

Request:

Method:

DELETE

URI Path(s):

/api/v1/logical-switches/<lswitch-id>

Request Headers:

n/a

Query Parameters:

LogicalSwitchDeleteParameters+

LogicalSwitchDeleteParameters (schema)

(Deprecated)

Name	Description	Type	Notes
cascade	Delete a Logical Switch and all the logical ports in it, if none of the logical ports have any attachment.	boolean	Default: "False"
detach	Force delete a logical switch If this is set to true, then logical switch is deleted regardless of whether or not it is added to NSGroup. If cascade is set to true in the meantime, then logical switch and all logical ports are deleted regardless of whether any logical port in this switch has attachments.	boolean	Default: "False"

Request Body:

n/a

Example Request:

DELETE https://<nsx-mgr>/api/v1/logical-switches/92225022-a786-4c7d-91d1-1f9afa6deebe

Successful Response:

Response Code:

200 OK

Response Headers:

n/a

Response Body:

n/a

Required Permissions:

crud

Feature:

switching_switches

Additional Errors:

• 301 Moved Permanently
• 307 Temporary Redirect
• 400 Bad Request
• 403 Forbidden
• 409 Conflict
• 412 Precondition Failed
• 500 Internal Server Error
• 503 Service Unavailable