3.3.4.125 ResetZoneHealth

The ResetZoneHealth operation inserts the zone health status reset event for zones hosted on DNS servers.

 <wsdl:operation name="ResetZoneHealth">
   <wsdl:input wsaw:Action="http://Microsoft.Windows.Ipam/IIpamServer/ResetZoneHealth" message="ipam:IIpamServer_ResetZoneHealth_InputMessage" />
   <wsdl:output wsaw:Action="http://Microsoft.Windows.Ipam/IIpamServer/ResetZoneHealthResponse" message="ipam:IIpamServer_ResetZoneHealth_OutputMessage" />
 </wsdl:operation>

Upon receiving the IIpamServer_ResetZoneHealth_InputMessage request message, the server performs the following processing steps. Upon successful completion of these steps, the server MUST respond with the IIpamServer_ResetZoneHealth_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 neither ResetZoneHealth.zoneId nor ResetZoneHealth.dnsServerId is greater than 0, an appropriate SOAP fault MUST be generated. 

  2. Initialize serverZoneRecordIds to be a list of 64-bit signed integers to hold the RecordId of rows in ADM_DNSServerForwardLookupZoneTable for which the zone health reset event is to be added. 

  3. If the ResetZoneHealth.zoneId value is greater than 0 and the ResetZoneHealth.dnsServerId value is lesser than or equal to 0: 

  4. Enumerate the rows in ADM_DNSServerForwardLookupZoneTable whose DnsZoneId is equal to ResetZoneHealth.zoneId

  5. For each row enumerated, add the RecordId to serverZoneRecordIds

  6. If ResetZoneHealth.dnsServerId value is greater than 0 and ResetZoneHealth.zoneId is lesser than or equal to 0: 

    1. Enumerate the rows in ADM_DNSServerForwardLookupZoneTable whose ServerRecordId is equal to ResetZoneHealth.dnsServerId

    2. For each row enumerated, add the RecordId to serverZoneRecordIds

    3. If both ResetZoneHealth.dnsServerId value and ResetZoneHealth.zoneId are greater than 0:  

    4. Look up the ADM_DNSServerForwardLookupZoneTable for the row whose ServerRecordId is equal to ResetZoneHealth.dnsServerId and DnsZoneId is equal to ResetZoneHealth.zoneId

    5. Add the RecordId of the row meeting the criteria above to serverZoneRecordIds.  

    6. For each record identifier RecordId present in serverZoneRecordIds:  

      1. Insert a row in the ADM_DnsZoneEventsTable with the following values: 

      1. ServerZoneId is set to the RecordId for which the zone health reset event is to be inserted. 

      2. EventId is set to 0. 

      3. LoggedEventLevel is set to Informational. 

      4. TaskCategory is set to 0. 

      5. LoggedOn is set to the current time in UTC.