请参阅 Application Integration 支持的连接器。
错误和错误处理
在 Application Integration 中,当您测试和发布集成时,或执行集成时可能会出错。这些错误可能是由各种客户端和服务器端问题引起的,它们大致分为以下内容:
- 永久性错误:所有客户端错误(例如身份验证失败、数据验证错误)均视为永久性错误。永久性错误会导致永久性任务失败。
- 暂时性错误:所有服务器端错误,例如 HTTP 503(服务不可用)、HTTP 400(错误请求)均视为暂时性错误。暂时性错误会导致临时任务失败。
错误消息显示在以下位置:
- 执行日志页面:显示集成执行期间发生的错误。集成的每次执行都有一个单独的日志条目。如需了解执行日志页面,请参阅执行日志。
- 集成编辑器页面:显示发布集成时发生的错误。错误会显示在集成编辑器页面底部。如需了解集成编辑器页面,请参阅集成编辑器。
如需了解您可能会遇到的错误代码列表,请参阅错误代码。
错误处理方法
Application Integration 提供了多种错误处理方法,以对创建、测试、发布或运行集成时遇到的错误做出响应并从中恢复。您可以将错误处理方法用于集成执行的同步和异步模式:
-
同步执行:在同步模式下,集成运行后很快就会提供集成的执行结果。如果您希望在集成运行后立即获得执行结果,同步模式会非常有用。触发器在同步模式下执行集成包括:
- 测试或发布集成
- 调用
projects.locations.integrations.execute
API - 从同步模式下的子集成调用集成
-
异步执行:异步执行使用触发和忘记模型。如果集成可能需要很长时间才能运行,或者集成运行后不需要立即获得执行结果,异步模式非常有用。在异步模式下执行集成的触发器包括:
- 所有非同步的执行都是在异步模式下执行的。一些常见的异步模式包括但不限于:
- 从挂起或审批任务中恢复的执行也会以异步模式执行,即使初始执行为同步模式也是如此。
Application Integration 支持以下错误处理方法,以便抛出、捕获、重试和自定义集成中遇到的错误:
错误代码
下表介绍了可能遇到的错误和相应的错误原因。Application Integration 使用 google.rpc.Code
中定义的规范错误代码。
如需了解 Application Integration 错误以及各种错误处理策略,请参阅错误和错误处理。
标准异常类型 | 规范代码 | HTTP 代码 | 说明 |
---|---|---|---|
FailedPreconditionException | FAILED_PRECONDITION |
400 | 请求无法在当前系统状态下执行。 |
BadRequestException | INVALID_ARGUMENT |
400 | 客户端指定了无效参数。如需了解详情,请查看错误消息和错误详细信息。 |
UnauthenticatedException | UNAUTHENTICATED |
401 | 由于 OAuth 令牌丢失、无效或过期,请求未通过身份验证。 |
ForbiddenException | PERMISSION_DENIED |
403 | 客户端权限不足。如果 OAuth 令牌没有正确的范围、客户端没有所需的权限或 API 尚未启用,则可能会发生这种情况。 |
NotFoundException | NOT_FOUND |
404 | 未找到指定的资源。 |
AlreadyExistsException | ALREADY_EXISTS |
409 | 客户端尝试创建的资源已存在。 |
InternalError | INTERNAL |
500 | 内部服务器错误。通常是服务器错误。 如果任何任务或触发器配置不正确,则可能会发生这种情况。 |
UnimplementedException | UNIMPLEMENTED |
501 | API 方法未通过服务器实现。 |
ServiceUnavailableException | UNAVAILABLE |
503 | 服务不可用。通常是服务器已关闭。 |
AbortedException | ABORTED |
409 | 响应大小过大。 |