Consulta los conectores compatibles para Application Integration.

Errores y manejo de errores

En Application Integration, pueden ocurrir errores cuando estás probando y publicando una integración, o durante la ejecución de una integración. Estos errores pueden ocurrir debido a varios problemas del cliente y del servidor, y se clasifican de forma amplia de la siguiente manera:

• Errores permanentes: Todos los errores del cliente, como errores de autenticación, errores de validación de datos, se consideran errores permanentes. Los errores permanentes provocan fallas permanentes de la tarea.
• Errores temporales: Todos los errores del servidor, como HTTP 503 (servicio no disponible) o HTTP 400 (solicitud incorrecta), se consideran errores temporales. Los errores temporales provocan fallas en las tareas temporales.

Los mensajes de error aparecen en las siguientes ubicaciones:

• Página de registros de ejecución: Muestra los errores detectados durante la ejecución de una integración. Cada ejecución de una integración tiene una entrada de registro separada. Para obtener información sobre la página Registros de ejecución, consulta Registros de ejecución.
• Página de editor de integración: Muestra los errores detectados cuando publicas una integración. Los errores se muestran en la parte inferior de la página del editor de integración. Para obtener más información sobre la página del editor de integración, consulta Editor de integración.

Para obtener información sobre los códigos de error que puedes encontrar, consulta Códigos de error.

Métodos de manejo de errores

Application Integration ofrece varios métodos de manejo de errores para responder y recuperarse de los errores que se encuentran cuando creas, pruebas, publicas o ejecutas tus integraciones. Puedes usar métodos de manejo de errores para los modos síncrono y asíncrono de ejecución de integración:

• Ejecuciones síncronas: En modo síncrono, el resultado de la ejecución de la integración está disponible poco después de la ejecución. El modo síncrono es útil en situaciones en las que deseas obtener el resultado de la ejecución inmediatamente después de la ejecución de la integración. Los activadores ejecutan la integración en el modo síncrono y, además, incluyen lo siguiente:
  • Cómo probar o publicar una integración
  • Llama a la API de projects.locations.integrations.execute
  • Llama a la integración desde una subintegración en modo síncrono.
• Ejecuciones asíncronas: Las ejecuciones asíncronas usan el modelo activar y olvidar. El modo asíncrono es útil en situaciones en las que las integraciones pueden tardar mucho tiempo en ejecutarse o el resultado de la ejecución no es necesario inmediatamente después de que se ejecuta la integración. Los activadores que ejecutan la integración en el modo asíncrono incluyen los siguientes:
  • Todas las ejecuciones que no son síncronas se ejecutan en modo asíncrono. Algunos de los modos asíncronos comunes incluyen, entre otros, los siguientes:
    • Activador de programación
    • Activador de Cloud Scheduler
    • Activador de Cloud Pub/Sub
    • Activador de Salesforce
    • Llama a la API de projects.locations.integrations.schedule
  • Las ejecuciones que se reanudan desde una suspensión o una tarea de aprobación también se ejecutan en modo asíncrono, incluso si la ejecución inicial fue en modo síncrono.

Application Integration admite los siguientes métodos de manejo de errores para arrojar, detectar, reintentar y personalizar los errores encontrados en tu integración:

• Estrategias de manejo de errores
• Detector de errores

Códigos de error

En la siguiente tabla, se describen los errores que podrías encontrar y las causas correspondientes de los errores. Application Integration usa los códigos de error canónicos definidos en google.rpc.Code.

Para obtener más información sobre los errores de Application Integration y las diferentes estrategias de manejo de errores, consulta Errores y manejo de errores.

Tipo de excepción estándar	Código canónico	Código HTTP	Descripción
FailedPreconditionException	FAILED_PRECONDITION	400	La solicitud no se puede ejecutar en el estado actual del sistema.
BadRequestException	INVALID_ARGUMENT	400	El cliente especificó un argumento no válido. Verifica el mensaje de error y los detalles de errores para obtener más información.
UnauthenticatedException	UNAUTHENTICATED	401	La solicitud no se autenticó debido a que el token de OAuth no es válido, falta o se venció.
ForbiddenException	PERMISSION_DENIED	403	El cliente no cuenta con los permisos necesarios. Esto puede suceder si el token de OAuth no tiene los alcances correctos, el cliente no tiene los permisos necesarios o la API no se habilitó.
NotFoundException	NOT_FOUND	404	No se encontró ningún recurso especificado.
AlreadyExistsException	ALREADY_EXISTS	409	El recurso que el cliente intentó crear ya existe.
InternalError	INTERNAL	500	Error del servidor interno Por lo general, un error de servidor. Esto puede suceder si alguna de las tareas o los activadores están configurados de forma incorrecta.
UnimplementedException	UNIMPLEMENTED	501	El servidor no implementó el método de la API.
ServiceUnavailableException	UNAVAILABLE	503	Servicio no disponible. Por lo general, el servidor no está en funcionamiento.
AbortedException	ABORTED	409	El tamaño de la respuesta es demasiado grande.