See the supported connectors for Application Integration.

Errors and error handling

In Application Integration, errors might occur when you're testing and publishing an integration, or during the execution of an integration. These errors can occur due to various client-side and server-side issues, and are broadly classified as follows:

• Permanent errors: All client-side errors such as, authentication failures, data validation errors, are considered as permanent errors. Permanent errors cause permanent task failures.
• Temporary errors: All server-side errors such as, HTTP 503 (service unavailable), HTTP 400 (bad request), are considered as temporary errors. Temporary errors cause temporary task failures.

Error messages appear in the following locations:

• Execution logs page: Displays errors encountered during the execution of an integration. Each execution of an integration has a separate log entry. For information about execution logs page, see Execution logs.
• Integration editor page: Displays errors encountered when you publish an integration. The errors are displayed at the bottom of the integration editor page. For information about the integration editor page, see Integration editor.

For information on the list of error codes that you might encounter, see Error codes.

Error handling methods

Application Integration offers multiple error handling methods to respond and recover from the errors that are encountered when creating, testing, publishing, or running your integrations. You can use error handling methods for both synchronous and asynchronous modes of integration execution:

• Synchronous executions: In synchronous mode, the execution result of the integration is available soon after the integration runs. Synchronous mode is helpful in scenarios where you want the execution result immediately after the integration runs. Triggers execute the integration in the synchronous mode include the following:
  • Test or publish an integration
  • Call the projects.locations.integrations.execute API
  • Call the integration from a sub-integration in the synchronous mode
• Asynchronous executions: Asynchronous executions use the fire and forget model. Asynchronous mode is helpful in scenarios where integrations can take a long time to run, or the execution result is not required immediately after the integration runs. Triggers that execute the integration in the asynchronous mode include the following:
  • All execution that are not synchronous are executed in asynchronous mode. Some of the common asynchronous mode includes, but is not limited to:
    • Schedule trigger
    • Cloud Scheduler trigger
    • Cloud Pub/Sub trigger
    • Salesforce trigger
    • Call the projects.locations.integrations.schedule API
  • Executions that are resumed from a suspension or a approval task are also executed in aynchronous mode, even if the initial execution was is synchronous mode.

Application Integration supports the following error handling methods to throw, catch, retry, and customize the errors encountered in your integration:

• Error handling strategies
• Error catcher

Error codes

The following table describes the errors that you might encounter, and the corresponding causes for the errors. Application Integration uses the canonical error codes defined in google.rpc.Code.

For information about Application Integration errors and different error handling strategies, see Errors and error handling.

Standard exception type	Canonical code	HTTP code	Description
FailedPreconditionException	FAILED_PRECONDITION	400	Request can not be executed in the current system state.
BadRequestException	INVALID_ARGUMENT	400	Client specified an invalid argument. Check error message and error details for more information.
UnauthenticatedException	UNAUTHENTICATED	401	Request not authenticated due to missing, invalid, or expired OAuth token.
ForbiddenException	PERMISSION_DENIED	403	Client does not have sufficient permission. This can happen if the OAuth token doesn't have the right scopes, the client doesn't have the required permissions, or the API has not been enabled.
NotFoundException	NOT_FOUND	404	A specified resource is not found.
AlreadyExistsException	ALREADY_EXISTS	409	The resource that a client tried to create already exists.
InternalError	INTERNAL	500	Internal server error. Typically a server bug. This can happen if any of the tasks or triggers are incorrectly configured.
UnimplementedException	UNIMPLEMENTED	501	API method not implemented by the server.
ServiceUnavailableException	UNAVAILABLE	503	Service unavailable. Typically the server is down.
AbortedException	ABORTED	409	Response size is too large.