错误和错误处理

公告：Application Integration 现在可供您的 Google Cloud 项目使用。现在，您可以在同一 Google Cloud 项目中同时使用 Apigee Integration 和 Application Integration 了。了解详情

在 Apigee Integration 中，当您测试和发布集成时，或者在集成执行期间，可能会出现错误。这些错误可能是由各种客户端和服务器端问题引起的，它们大致分为以下内容：

• 永久性错误：所有客户端错误（例如身份验证失败、数据验证错误）均视为永久性错误。永久性错误会导致永久性任务失败。
• 暂时性错误：所有服务器端错误，例如 HTTP 503（服务不可用）、HTTP 400（错误请求）均视为暂时性错误。暂时性错误会导致临时任务失败。

错误消息显示在以下位置：

• 执行日志页面：显示集成执行期间发生的错误。集成的每次执行都有一个单独的日志条目。如需了解执行日志页面，请参阅执行日志。
• 集成编辑器页面：显示发布集成时发生的错误。错误会显示在集成编辑器页面底部。如需了解集成编辑器页面，请参阅集成编辑器。

如需了解您可能会遇到的错误代码列表，请参阅错误代码。

错误处理方法

Apigee Integration 提供了多种错误处理方法，可以响应创建、测试、发布或运行集成时遇到的错误并从中恢复。您可以将错误处理方法同时用于集成执行的同步和异步模式：

• 同步执行：在同步模式下，集成运行后不久即可获得集成的执行结果。如果您希望在集成运行后立即获得执行结果，则同步模式非常有用。以同步模式执行集成的触发器包括：
  • 测试或发布集成
  • 调用 projects.locations.integrations.execute API
  • 从同步模式下的子集成调用集成
• 异步执行：异步执行使用即发即弃模型。如果集成运行可能需要很长时间，或者在集成运行后不需要立即获得执行结果，则异步模式非常有用。以异步模式执行集成的触发器包括：
  • 所有非同步的执行都会以异步模式执行。一些常见的异步模式包括但不限于：
    • 时间表触发器
    • Cloud Scheduler 触发器
    • Cloud Pub/Sub 触发器
    • Salesforce 触发器
    • 调用 projects.locations.integrations.schedule API
  • 从暂停或审批任务恢复的执行也会以异步模式执行，即使初始执行为同步模式也是如此。

Apigee Integration 支持以下错误处理方法以抛出、捕获、重试和自定义集成中遇到的错误：

• 错误处理策略
• 错误捕获器

错误代码

下表介绍了可能遇到的错误和相应的错误原因。Apigee Integration 使用 google.rpc.Code 中定义的规范错误代码。

如需了解 Apigee 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	响应大小过大。