3.3.4.83 UpdateLogicalGroup

  • Article

This operation can be used to modify an existing logical group.

 <wsdl:operation name="UpdateLogicalGroup">
   <wsdl:input wsaw:Action="http://Microsoft.Windows.Ipam/IIpamServer/UpdateLogicalGroup" message="ipam:IIpamServer_UpdateLogicalGroup_InputMessage" />
   <wsdl:output wsaw:Action="http://Microsoft.Windows.Ipam/IIpamServer/UpdateLogicalGroupResponse" message="ipam:IIpamServer_UpdateLogicalGroup_OutputMessage" />
 </wsdl:operation>

Upon receiving the IIpamServer_UpdateLogicalGroup_InputMessage request message, the server performs the following processing steps. Upon successful completion of the steps specified below, the server MUST respond with the IIpamServer_UpdateLogicalGroup_OutputMessage message. 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 UpdateLogicalGroup.logicalgroup is null, an appropriate SOAP fault MUST be generated.

  2. Validate the UpdateLogicalGroup.logicalgroup as specified under the section ValidateLogicalGroup. If any of the validation steps fail, an appropriate SOAP fault MUST be generated.

  3. If UpdateLogicalGroup.logicalgroup.ModifiedProperties is an empty list, there are no properties to modify and the operation is completed successfully.

  4. The LogicalGroupOrigin cannot be modified after the logical group has been created. If LogicalGroupOrigin is part of UpdateLogicalGroup.logicalgroup.ModifiedProperties, an appropriate SOAP fault MUST be generated.

  5. If the UpdateLogicalGroup.logicalgroup.Origin is LogicalGroupOrigin, the UpdateLogicalGroup.logicalgroup.ModifiedProperties MUST NOT contain LogicalGroupName, LogicalGroupOrigin.

  6. Update the logical group information in ADM_LogicalGroupsTable with the values for the logical group specified in UpdateLogicalGroup.logicalgroup.