Create
The FIM Service Resource Factory Endpoint implements the Create operation defined in the WS-Transfer: Identity Management Operations for Directory Access Extensions. The default endpoint address for Create is https://Localhost:5725/ResourceManagementService/ResourceFactory.
Headers
None.
Parameters
Action Header
Refer to the WS-Transfer: Identity Management Operations for Directory Access Extensions specification.
Initial State
In accordance with the WS-Transfer: Identity Management Operations for Directory Access Extensions, the Create operation accepts as input an XML representation of the initial state of the object to be created. For more information, see WS-Transfer IMO.
See How to: Retrieve the FIM Service Schema Using WS-MetadataExchange for information about retrieving the schema for the objects and properties in FIM.
Return Values
Action Header
Refer to the WS-Transfer specification.
Endpoint Reference Element
The WS-Transfer specification says that the response to a successful invocation of the Create operation must identify the object that has been created. The specification says that the response must do so in the form of an endpoint reference, as defined by the WS-Addressing specification. According to WS-Addressing, an endpoint reference consists of an address in the form of a Uniform Resource Identifier (URI) and optional reference properties for identifying a particular resource available at the address.
The endpoint address returned in response to a successful invocation of the Create operation will be the address of the Resource endpoint of the FIM Service. The reference property value that will be provided for identifying an object takes the form defined by the following XML Schema.
Exceptions
The FIM Service endpoints respond to exceptions by returning SOAP faults to their clients. The WS-Transfer specification defines some faults that the Resource Factory endpoint may return. However, there are additional SOAP faults, specific to the FIM Service, that may be returned. For more information, see Message-Specific Authentication.
Examples
Example of a Request to Create an Object
The following is an example of a request to the FIM Service to create an object. The text in bold indicates the part of the message that is specific to the FIM Service implementation of the WS-Transfer specification.
<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://www.w3.org/2003/05/soap-envelope"
xmlns:i="http://www.w3.org/2001/XMLSchema-instance"
xmlns:da="https://schemas.microsoft.com/2006/11/IdentityManagement/DirectoryAccess"
xmlns:wsa="http://www.w3.org/2005/08/addressing">
<s:Header>
<wsa:Action
s:mustUnderstand="1">https://schemas.xmlsoap.org/ws/2004/09/transfer/Create</wsa:Action>
<da:IdentityManagementOperation s:mustUnderstand="1" />
<wsa:ReplyTo>
<wsa:Address>http://www.w3.org/2005/08/addressing/anonymous</wsa:Address>
</wsa:ReplyTo>
<wsa:To
s:mustUnderstand="1">https://localhost:5725/ResourceManagementService/ResourceFactory</wsa:To>
</s:Header>
<s:Body>
<da:AddRequest
Dialect="https://schemas.microsoft.com/2006/11/ResourceManagement/Dialect/IdentityAttributeTyp
e-20080602">
<da:AttributeTypeAndValue>
<da:AttributeType>ObjectType</da:AttributeType>
<da:AttributeValue>
<rm:ObjectType>ma-data</rm:ObjectType>
</da:AttributeValue>
</da:AttributeTypeAndValue>
<da:AttributeTypeAndValue>
<da:AttributeType>DisplayName</da:AttributeType>
<da:AttributeValue>
<rm:DisplayName>
Active Directory Management Agent
</rm:DisplayName>
</da:AttributeValue>
</da:AttributeTypeAndValue>
</da:AddRequest>
</s:Body>
</s:Envelope>
<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://www.w3.org/2003/05/soap-envelope"
xmlns:i="http://www.w3.org/2001/XMLSchema-instance"
xmlns:da="https://schemas.microsoft.com/2006/11/IdentityManagement/DirectoryAccess"
xmlns:wsa="http://www.w3.org/2005/08/addressing">
<s:Header>
<wsa:Action
s:mustUnderstand="1">https://schemas.xmlsoap.org/ws/2004/09/transfer/Create</wsa:Action>
<da:IdentityManagementOperation s:mustUnderstand="1" />
<wsa:ReplyTo>
<wsa:Address>http://www.w3.org/2005/08/addressing/anonymous</wsa:Address>
</wsa:ReplyTo>
<wsa:To
s:mustUnderstand="1">https://localhost:5725/ResourceManagementService/ResourceFactory</wsa:To>
</s:Header>
<s:Body>
<da:AddRequest
Dialect="https://schemas.microsoft.com/2006/11/ResourceManagement/Dialect/IdentityAttributeTyp
e-20080602">
<da:AttributeTypeAndValue>
<da:AttributeType>ObjectType</da:AttributeType>
<da:AttributeValue>
<rm:ObjectType>ma-data</rm:ObjectType>
</da:AttributeValue>
</da:AttributeTypeAndValue>
<da:AttributeTypeAndValue>
<da:AttributeType>DisplayName</da:AttributeType>
<da:AttributeValue>
<rm:DisplayName>
Active Directory Management Agent
</rm:DisplayName>
</da:AttributeValue>
</da:AttributeTypeAndValue>
</da:AddRequest>
</s:Body>
</s:Envelope>
Response to Successful Request to Create an Object
A response to a successful invocation of the Create operation to create an ma-data resource might resemble the response message shown here. Once again, bold text indicates the part of the message that is specific to the FIM Service implementation of the WS-Transfer and WS-Addressing specifications.
<s:Envelope xmlns:a="http://www.w3.org/2005/08/addressing"
xmlns:s="http://www.w3.org/2003/05/soap-envelope">
<s:Header>
<a:Action
s:mustUnderstand="1">https://schemas.xmlsoap.org/ws/2004/09/transfer/CreateResponse</a:Action>
<a:RelatesTo>urn:uuid:0ad4aa5a-80d2-4afb-a7ba-718b93dc1f53</a:RelatesTo>
</s:Header>
<s:Body>
<ResourceCreated xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns="https://schemas.xmlsoap.org/ws/2004/09/transfer">
<EndpointReference xmlns="https://schemas.xmlsoap.org/ws/2004/08/addressing">
<Address>http://10.195.162.92:5725/ResourceManagementService/Resource</Address>
<ReferenceProperties>
<ResourceReferenceProperty
xmlns="https://schemas.microsoft.com/2006/11/ResourceManagement">urn:uuid:fa14aafd-d74b-4833-
bd94-94c96ee1b278</ResourceReferenceProperty>
</ReferenceProperties>
</EndpointReference>
</ResourceCreated>
</s:Body>
</s:Envelope>