Management Plane API > Networking > Services > DHCP

Delete a single DHCP lease entry specified by ip and mac.

Delete a single DHCP lease entry specified by ip and mac.

The DHCP server matches the DHCP lease with the given ip address and
the mac address. The matched lease entry will be deleted. If no lease
matches, the request is 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.

Request:

Method:
DELETE
URI Path(s):
/api/v1/dhcp/servers/<server-id>/leases
Request Headers:
n/a
Query Parameters:
DhcpDeleteLeaseRequestParameters+
Request Body:
n/a

Example Request:

DELETE /api/v1/dhcp/servers/d7f425da-25d2-4e5e-ae9e-ea112375971d/leases?ip=192.168.100.6&mac=02:42:21:4d:bc:b7

Successful Response:

Response Code:
200 OK
Response Headers:
Content-type: application/json
Response Body:
n/a

Required Permissions:

crud

Feature:

dhcp_servers

Additional Errors: