3.3.4.158 PurgeIPUtilizationData
The PurgeIPUtilizationData operation initiates the purge of the rows in the various utilization tables in the IPAM data store.
-
<wsdl:operation name="PurgeIPUtilizationData"> <wsdl:input wsaw:Action="http://Microsoft.Windows.Ipam/IIpamServer/PurgeIPUtilizationData" message="ipam:IIpamServer_PurgeIPUtilizationData_InputMessage" /> <wsdl:output wsaw:Action="http://Microsoft.Windows.Ipam/IIpamServer/PurgeIPUtilizationDataResponse" message="ipam:IIpamServer_PurgeIPUtilizationData_OutputMessage" /> </wsdl:operation>
Upon receiving the IIpamServer_PurgeIPUtilizationData_InputMessage request message, the server performs the following processing steps. Upon successful completion of these steps, the server MUST respond with the IIpamServer_PurgeIPUtilizationData_OutputMessage. In the event of a failure, an appropriate SOAP fault MUST be sent to the client as specified in section 2.2.2.1.
If EndDate is not greater than the current date, then the following steps are performed in an asynchronous manner and the response message is also sent out. If EndDate is greater than the current date, an appropriate SOAP fault MUST be returned:
Set ADM_IsUtilizationPurgeInProgress to TRUE.
Set ADM_CommonProperties.LastUtilizationPurgeResult to "" (empty string).
Delete rows from ADM_IPv4AddressRangeUtilizationTable and ADM_IPv4AddressBlockUtilizationTable whose TimeOfEvent is lesser than or equal to EndDate specified.
Set ADM_IsUtilizationPurgeInProgress to FALSE.
If during the processing of the utilization purge, any SOAP fault was generated, set ADM_CommonProperties.LastUtilizationPurgeResult to the fault information.