SOAP Faults

From $1

    Doc-Wiki-BannerHK.png

    (Click the banner to go to the related Docs.Code.ExactTarget.com page.)

    This document contains conceptual and procedural information regarding SOAP faults. These faults can occur for reasons addressed in the error messages details below.

    What Are SOAP Faults

    SOAP faults reflect errors encountered when you send SOAP calls via the web service API to the ExactTarget system. These faults indicate that the call was not completed successfully and give the reason why the error occurred.

    SOAP Faults

    The following examples include the SOAP fault, the error code, and the reason for the fault.

    Unplanned Outage

    This general exception indicated that the server cannot process the requests because the servers are offline.

    Authentication (Login has an Unexpected Exception)

    • Server Fault
    • Code: UnexpectedError = 2

    Unexpected Error Passing Authentication Credentials to Authorization Filter

    • Server Fault
    • Code: UnexpectedError = 2

    Caused By a Request When System is Inaccessible

    • Server Fault
    • Code: UnexpectedError = 2

    User Not Authorized

    The following example indicates the user does not have the proper authorization to use the web service API.

    The User's Access Has Not Been Set

    • Client Fault
    • Code: AuthorizationFailure = 11
    • Resolved by setting user's web service permission to on

    Account Not Authorized

    The following example indicates the user's account is in authorized to access the web service API.

    The Account Has Not Had the Web Service Feature Activated

    • Client Fault
    • Code: AuthorizationFailure = 11
    • Resolved by contacting ExactTarget representative and activating web service API

    Missing SOAP Action

    The following example indicates the web service API cannot determine the SOAP action in the call. The system expects the SOAP action as an HTTP header or WS-Addressing:Action.

    SOAP Action Could Not Be Determined From HTTP or SOAP Header

    • Client Fault
    • Code: UnexpectedError = 2
    • Resolved by including appropriate SOAP header
    • Normally not an issue for requests generated in .NET or Axis framework

    Unsupported Objects for Always On Operation

    The following examples indicate that a request made to objects not authorized to be processed by the allowed operation during maintenance. The system checks every request for an account in maintenance mode to see if the operation requested is flagged as always on. If the request is allowed, the system performs a second check to validate the objects being requested to be processed. If any of the objects are not allowed to be processed by an always on operation during maintenance, the system rejects the whole request and returns a fault.

    Error Message

    Member: [{0}] is In Maintenance. The operation: [{1}] is authorized to process or queue while in maintenance however the object or objects: [{2}] are not. Please remove objects from request and try again or resubmit request once the member is out of maintenance state.

    • Client Fault
    • Code: UnsupportedObject = 8
    • Resolved by removing the objects causing the exception and resubmitting the call or waiting until maintenance is over.

    In Maintenance

    The system processes only Always On requests while in maintenance. It rejects all other objects and returns an In Maintenance fault.

    Request an Operation While Member is in Maintenance

    • Server Fault
    • Code: InMaintenance = 9

    Synchronous Request Cannot Be Be Requested

    The system cannot receive synchronous requests at the time and returns this error.

    Error Message

    Synchronous request cannot be completed at this time due to database problems. This request was not processed.

    • Client Fault
    • Code: RemoteDBConnDetected_SyncAPICallUnsupported= 1
    • Resolved by waiting for database connection or resubmitting request asynchronously

    This page was last updated by Ryan Williams on Fri, 06 Jan 2012 21:26:59 GMT.

    If you require assistance with the ExactTarget application, please contact Global Support. If you wish to send Ryan direct feedback, fill out the form below:

     


    Was This Page Helpful?
    Suggestions or Comments:
    Name (optional):
    Email Address (optional):
    Enter 16450 backwards:
       
    Tags: (Edit tags)
    • No tags
     
    Comments (0)
    You must login to post a comment.

     
    Powered by MindTouch 2010
    Admin