3.3.4.4 BulkUpdateRanges
The BulkUpdateRanges operation provides the ability to modify multiple ranges with a single operation.
-
<wsdl:operation name="BulkUpdateRanges"> <wsdl:input wsaw:Action="http://Microsoft.Windows.Ipam/IIpamServer/BulkUpdateRanges" message="ipam:IIpamServer_BulkUpdateRanges_InputMessage" /> <wsdl:output wsaw:Action="http://Microsoft.Windows.Ipam/IIpamServer/BulkUpdateRangesResponse" message="ipam:IIpamServer_BulkUpdateRanges_OutputMessage" /> </wsdl:operation>
Upon receiving the IIpamServer_BulkUpdateRanges_InputMessage, the server performs the following processing steps. Upon successful completion of these steps, the server MUST respond with the IIpamServer_BulkUpdateRanges_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 the BulkUpdateRanges.rangesToUpdate is NULL or there are no elements in the collection, set the BulkUpdateRangesResponse.BulkUpdateRangesResult to NULL and return.
Initialize BulkUpdateRangesResponse.BulkUpdateRangesResult to a collection of key value pairs.
If BulkUpdateRanges.addressFamily is InterNetwork, then IPv4-specific operations are used in further processing. Otherwise, IPv6 based operations are used.
For each IPRange in the BulkUpdateRanges.rangesToUpdate:
Set the updatedRange to the range entry.
Perform the range update as specified in section 3.2.4.2.
If the above step generates any SOAP fault, add the failure information of the SOAP fault to the BulkUpdateRangesResponse.BulkUpdateRangesResult with the key having the updatedRange.RecordId and the value having the IpamException having the fault information.