3.3.4.3 BulkUpdateIPAddresses

The BulkUpdateIPAddresses operation provides the ability to modify multiple IP addresses with a single operation in the IPAM data store.

 <wsdl:operation name="BulkUpdateIPAddresses">
   <wsdl:input wsaw:Action="http://Microsoft.Windows.Ipam/IIpamServer/BulkUpdateIPAddresses" message="ipam:IIpamServer_BulkUpdateIPAddresses_InputMessage" />
   <wsdl:output wsaw:Action="http://Microsoft.Windows.Ipam/IIpamServer/BulkUpdateIPAddressesResponse" message="ipam:IIpamServer_BulkUpdateIPAddresses_OutputMessage" />
 </wsdl:operation>

Upon receiving the IIpamServer_BulkUpdateIPAddresses_InputMessage, the server performs the following processing steps. Upon successful completion of the steps specified below, the server MUST respond with the IIpamServer_BulkUpdateIPAddresses_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 the BulkUpdateIPAddresses.addressfamily is InterNetwork, the processing is done with the IPv4-specific tables. Otherwise, use IPv6-specific tables for further processing.

  2. If the BulkUpdateIPAddresses.addressesToUpdate is NULL or there are no elements in the collection, set the BulkUpdateIPAddressesResponse.BulkUpdateIPAddressesResult to NULL and return.

  3. Initialize BulkUpdateIPAddressesResponse.BulkUpdateIPAddressesResult to a collection of key value pairs.

  4. For each IpamIPAddress in the BulkUpdateIPAddresses.addressesToUpdate:

    1. Set the updateIpAddress to the IpamIpAddress entry.

    2. Perform the address update as specified in UpdateIpamIPAddressDelegate (section 3.19.4.4.1.37).

    3. If the above step generates a SOAP fault, add the failure information of the SOAP fault to the BulkUpdateIPAddressesResponse.BulkUpdateIPAddressesResult with the key having the updateIpAddress.RecordId and the value having the IpamException having the fault information.