3.3.4.29 DeleteIPV4Reservation

The DeleteIPV4Reservation operation is used to delete an existing IPv4 reservation.

 <wsdl:operation name="DeleteIPV4Reservation" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">
   <wsdl:input wsaw:Action="http://Microsoft.Windows.Ipam/IIpamServer/DeleteIPV4Reservation" message="ipam:IIpamServer_DeleteIPV4Reservation_InputMessage" xmlns:wsaw="http://www.w3.org/2006/05/addressing/wsdl" />
   <wsdl:output wsaw:Action="http://Microsoft.Windows.Ipam/IIpamServer/DeleteIPV4ReservationResponse" message="ipam:IIpamServer_DeleteIPV4Reservation_OutputMessage" xmlns:wsaw="http://www.w3.org/2006/05/addressing/wsdl" />
 </wsdl:operation>

Upon receiving the IIpamServer_DeleteIPv4Reservation_InputMessage request message, the server performs the following processing steps. Upon successful completion of these steps, the server MUST respond with the IIpamServer_DeleteIPv4Reservation_OutputMessage message. In the event of a failure, an appropriate SOAP fault MUST be sent to the client as specified in section 2.2.2.1:

  1. If any of the following conditions is not satisfied, an appropriate SOAP fault MUST be generated:

    • DeleteIPv4Reservation.ipAddress is NULL.

    • DeleteIPv4Reservation.ipAddress.Address is NULL.

    • DeleteIPv4Reservation.ipAddress.ReservationServerName is NULL.

  2. Call the procedure DeleteReservation in ADM_DHCPReservationTable passing the reservation details from the input message. If the procedure deleted the reservation successfully, return the IpamIpAddress in the DeleteIPv4ReservationResponse element. Else a SOAP fault MUST be raised.

  3. Set DeleteIPv4Reservation.ipAddress.ReservationSyncStatus to ipam:DhcpReservationSyncStatus as DeleteSuccess and update the corresponding row in ADM_IPAddressTable.

  4. If step 2 resulted in an error, set DeleteIPv4Reservation.ipAddress.ReservationSyncStatus to ipam:DhcpReservationSyncStatus as DeleteFailure and update the corresponding row in ADM_IPAddressTable.