Policy > Networking > IP Management > DHCP > DHCP Leases

Delete DHCP lease(s) specified by IP and MAC

Delete one or multiple DHCP lease(s) specified by IP and MAC.

If there is a DHCP server running upon the given segment, or this segment
is using a DHCP server running in its connected Tier-0 or Tier-1, the DHCP
lease(s) which match exactly the IP address and the MAC address will be
deleted. If no such lease matches, the deletion for this lease will be
ignored.

The DHCP lease to be deleted will be removed by the system from both active
and standby node. The system will report error if the DHCP lease could not
be removed from both nodes. If the DHCP lease could not be removed on either
node, please check the DHCP server status. Once the DHCP server status is
UP, please invoke the deletion API again to ensure the lease gets deleted
from both nodes.
This API is available when using VMware Cloud (AWS, Dell-EMC, Outpost, Hyperscalers) or VMware NSX-T.

Request:

Method:
POST
URI Path(s):
/policy/api/v1/infra/segments/<segment-id>?action=delete_dhcp_leases
Request Headers:
n/a
Query Parameters:
EnforcementPointRequest+
Request Body:
DhcpDeleteLeases+

Example Request:

POST /infra/segments/seg-1?action=delete_dhcp_leases { "leases": [ { "ip": "40.1.1.1", "mac": "02:42:21:4d:bc:b7" } ] }

Successful Response:

Response Code:
200 OK
Response Headers:
n/a
Response Body:
n/a

Example Response:

200 OK

Required Permissions:

crud

Feature:

policy_segment

Additional Errors: