3.3.4.14 CreateUserAccessPolicy

The CreateUserAccessPolicy operation is used to create a new access policy in the IPAM data store.

 <wsdl:operation name="CreateUserAccessPolicy">
   <wsdl:input wsaw:Action="http://Microsoft.Windows.Ipam/IIpamServer/CreateUserAccessPolicy" message="ipam:IIpamServer_CreateUserAccessPolicy_InputMessage" />
   <wsdl:output wsaw:Action="http://Microsoft.Windows.Ipam/IIpamServer/CreateUserAccessPolicyResponse" message="ipam:IIpamServer_CreateUserAccessPolicy_OutputMessage" />
 </wsdl:operation>

The protocol client sends an IIpamServer_CreateUserAccessPolicy_InputMessage request. The server then performs the following processing steps. When the operation completes successfully, the protocol server MUST respond with the IIpamServer_CreateUserAccessPolicy_OutputMessage response. 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 CreateUserAccessPolicy.policy is NULL, then an appropriate SOAP fault MUST be generated as specified in section 2.2.2.1.

  2. The method ValidateUserAccessPolicy is used to validate CreateUserAccessPolicy.policy.

  3. A new row is added to ADM_UserAccessPolicyTable for CreateUserAccessPolicy.policy. CreateUserAccessPolicy.policy.policyId and CreateUserAccessPolicy.policy.UserGroupId is updated and passed in the output message.