3.3.4.8 CreateAccessScope
The CreateAccessScope operation is used to create an access scope entry in the IPAM data store.
-
<wsdl:operation name="CreateAccessScope"> <wsdl:input wsaw:Action="http://Microsoft.Windows.Ipam/IIpamServer/CreateAccessScope" message="ipam:IIpamServer_CreateAccessScope_InputMessage" /> <wsdl:output wsaw:Action="http://Microsoft.Windows.Ipam/IIpamServer/CreateAccessScopeResponse" message="ipam:IIpamServer_CreateAccessScope_OutputMessage" /> </wsdl:operation>
The protocol client sends an IIpamServer_CreateAccessScope_InputMessage request. The server then performs the following processing steps. When the operation completes successfully, the protocol server MUST respond with the IIpamServer_CreateAccessScope_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:
If either of the following conditions is not met, an appropriate SOAP fault MUST be generated as specified in section 2.2.2.1:
CreateAccessScope.accessScope is not NULL.
CreateAccessScope.parentPath is not NULL.
The method ValidateAccessScope is used to validate the CreateAccessScope.accessScope.
The level of the parent access scope is determined by splitting the CreateAccessScope.parentPath at the "\" symbol and identifying the total number of tokens. If the level is less than 8, continue to the next step. If not, an appropriate SOAP fault section 2.2.2.1 MUST be generated.
Call method GetAllAccessScopes from the ADM_AccessScopeTable to get the collection of all AccessScope objects in the IPAM data store. From this collection find the object whose FullScopePath matches CreateAccessScope.parentPath. If no matching object is found, a fault MUST be generated as specified in section 2.2.2.1.
A new row is created in ADM_AccessScopeTable for CreateAccessScope.accessScope, with the FullScopePath created by appending "\CreateAccessScope.accessScope.Label>" to CreateAccessScope.parentPath. The RecordId of the created record is returned in the output message.