3.1.4.1 Get

  • Article

The protocol client uses the Get operation to retrieve specific identity attributes of one configuration object.

A client sends the message BaseObjectSearchRequestMessage (section 2.2.2.3) to request the server to retrieve an existing configuration object. If the server accepts the request, the server MUST send message BaseObjectSearchResponseMessage (section 2.2.2.4) in response.

  
 s:Header/rm:ResourceReferenceProperty

The server MUST use the value in the request message SOAP header element rm: ResourceReferenceProperty (section 2.2.3.22) to identify which configuration object to retrieve. If the element rm:ResourceReferenceProperty is not present, then the server behavior is undefined.

  
 da:BaseObjectSearchResponse/da:PartialAttribute

The element da:BaseObjectSearchResponse in message BaseObjectSearchResponseMessage MUST include one element da:PartialAttribute (section 2.2.3.16) for each element da:AttributeType (section 2.2.3.2) in the element da:BaseObjectSearchRequest in message BaseObjectSearchRequestMessage. The server MUST respond with the current value of each requested identity attribute.

If the client does not have permission to retrieve any of the requested identity attributes of the configuration object, then the server MUST respond with the PermissionDeniedFault (section 2.2.2.11) SOAP fault.

If the client provides a malformed BaseObjectSearchRequestMessage message that does not satisfy the definition in section 2.2.2.3, then the server behavior is undefined.

     <wsdl:operation name="Get">
       <soap12:operation soapAction="http://schemas.xmlsoap.org/ws/2004/09/transfer/Get" style="document" />
       <wsdl:input message="da:BaseObjectSearchRequestMessage" wsa:Action="http://schemas.xmlsoap.org/ws/2004/09/transfer/Get">
         <soap12:body use="literal" />
         <soap12:header message="da:BaseObjectSearchRequestMessage" part="operationheader" use="literal"/>
       </wsdl:input>
       <wsdl:output message="da:BaseObjectSearchResponseMessage" wsa:Action="http://schemas.xmlsoap.org/ws/2004/09/transfer/GetResponse">
         <soap12:body use="literal" />
       </wsdl:output>
       <wsdl:fault name="InvalidRepresentation ">
         <soap12:fault use="literal" name="InvalidRepresentation" namespace="http://schemas.xmlsoap.org/ws/2004/09/transfer" />
       </wsdl:fault>
       <wsdl:fault name="PermissionDeniedFault">
         <soap12:fault use="literal" name="PermissionDeniedFault" namespace="http://schemas.microsoft.com/2006/11/ResourceManagement" />
       </wsdl:fault>
     </wsdl:operation>