Share via


Delete

The Resource Endpoint of FIM implements the WS-Transfer Delete operation for deleting an object. The default endpoint address for Delete is https://localhost:5725/ResourceManagementService/Resource.

Parameters

Action Header

Refer to the WS-Transfer specification.

Reference Property Header

Refer to the description of the Reference Property header as a parameter for the Get operation. See Resource Factory Endpoint. The same device is used as input to the Delete operation to identify the object to which the Delete operation is to be applied. The Time and Locale properties are not allowed for Delete operations.

Return Values

Action Header

Refer to the WS-Transfer: Identity Management Operations for Directory Access Extensions specification.

Example

Sample invocation of the Delete operation to remove a Group

A sample invocation of the Delete operation of the FIM Service Resource endpoint is shown here.

<s:Envelope 
  xmlns:s="http://www.w3.org/2003/05/soap-envelope" 
  xmlns:wsa="https://schemas.xmlsoap.org/ws/2004/08/addressing" 
  xmlns:rm="https://schemas.microsoft.com/2006/11/ResourceManagement">
  xmlns:da="https://schemas.microsoft.com/2006/11/IdentityManagementService/DirectoryAccess">
  <s:Header>
    <wsa:ReplyTo>
      <wsa:Address>
        http://www.woodgrovebank.com/sender
      </wsa:Address>
    </wsa:ReplyTo>
    <wsa:To>
      http://www.woodgrovebank.com:5725/IdentityManagementService/Resource
    </wsa:To>
    <rm:ResourceReferenceProperty>
      03CED96B-BE01-4C18-95A5-FCD2FAA09C25
    </rm:ResourceReferenceProperty>
    <wsa:Action>
      https://schemas.xmlsoap.org/ws/2004/09/transfer/Delete
    </wsa:Action>
    <wsa:MessageID>
      uuid:00000000-0000-0000-C000-000000000046
    </wsa:MessageID>
    <rm:ResourceManagement s:mustUnderstand=“true"/>
  </s:Header>
  <s:Body/>
</s:Envelope>

Exceptions

The FIM Service's endpoints respond to exceptions by returning SOAP faults to their clients. The WS-Transfer specification and the WS-Transfer: Identity Management Operations for Directory Access Extensions specification define several such faults that the Resource endpoint may return. There are additional SOAP faults, specific to the FIM Service, that may also be returned.

Supplying a Locale property will result in an Endpoint Not Available exception.

See Also

Concepts

Web Services Overview