3.3.4.122 PurgeAuditData

The PurgeAuditData operation initiates the purge of the rows in the various audit tables in the IPAM data store.

 <wsdl:operation name="PurgeAuditData">
   <wsdl:input wsaw:Action="http://Microsoft.Windows.Ipam/IIpamServer/PurgeAuditData" message="ipam:IIpamServer_PurgeAuditData_InputMessage" />
   <wsdl:output wsaw:Action="http://Microsoft.Windows.Ipam/IIpamServer/PurgeAuditDataResponse" message="ipam:IIpamServer_PurgeAuditData_OutputMessage" />
 </wsdl:operation>

Upon receiving the IIpamServer_PurgeAuditData_InputMessage request message, the server performs the following processing steps. Upon successful completion of these steps, the server MUST respond with the IIpamServer_PurgeAuditData_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:

  1. If PurgeAuditData.auditPurge is not NULL, and EndDate is specified and is greater than the current date and time, and at least one of the following settings is set to TRUE, perform the following steps:

  2. PurgeIPAddressAudit

  3. PurgeIpamConfigurationAudit

  4. EndDate: MUST be specified and MUST NOT be greater than current date and time.

  5. The following steps are performed in an asynchronous manner once the response message is also sent out:

  6. Set ADM_IsAuditPurgeInProgress to TRUE.

  7. Set ADM_CommonProperties.LastPurgeAuditResult to "" (empty string).

  8. If PurgeAuditData.auditPurge.PurgeDhcpConfigurationAudit is TRUE, delete rows from ADM_ConfigurationAuditTable whose TimeOfEvent is lesser than or equal to EndDate specified and ServerType is DHCP.

  9. If PurgeAuditData.auditPurge.PurgeIPAddressAudit is TRUE, delete rows from ADM_IPAddressAuditTable whose TimeOfEvent is lesser than or equal to EndDate specified.

  10. If PurgeAuditData.auditPurge.PurgeIpamConfigurationAudit is TRUE, delete rows from ADM_ConfigurationAuditTable whose TimeOfEvent is lesser than or equal to EndDate specified and ServerType is IPAM.

  11. Set ADM_IsAuditPurgeInProgress to FALSE.

  12. If during the processing of the audit purge, any SOAP fault was generated, set ADM_CommonProperties.LastPurgeAuditResult to the fault information.