什么是扩展程序?

您正在查看 Apigee Edge 文档。
前往 Apigee X 文档
信息

您可以使用扩展程序将外部资源集成到 API 代理中。例如,您可以集成 Google Cloud Storage 等 Google Cloud Platform 服务。在运行时,API 代理使用该扩展程序与外部资源交换请求和响应。

扩展程序运行时框架

在运行时,扩展程序充当中介,处理 API 代理与外部资源之间的请求和响应。

下面简要介绍了通过扩展程序在运行时进行处理的工作原理。

  1. 客户端请求到达 API 代理,其请求流程会按照代理的政策继续进行。
  2. 请求流会到达代理中的扩展程序宣传信息政策,该政策配置为将数据传递给部署在环境中的扩展程序。这些数据包含向扩展程序代表的外部资源发送请求所需的值。
  3. 扩展程序外部资源发送请求,然后接收响应。
  4. 扩展程序会将其响应传回给“扩展程序宣传信息”政策,由代理代码进行处理。
  5. 请求流会继续通过代理,直到代理向客户端返回响应。

使用扩展程序

每个扩展程序的开发和配置都以特定的外部资源为依据。如需使用扩展程序,Apigee Edge 管理员和 API 代理开发者需要按照以下大致步骤操作:

  • Apigee Edge 组织管理员配置并部署该扩展程序。他们会使用特定于业务需求的值对其进行配置。此配置会创建一个扩展程序实例,供 API 代理开发者使用。例如,他们可以配置扩展程序以访问 Google Cloud Storage 中的特定存储分区,包括所需的身份验证凭据。
  • API 代理开发者可以通过向代理添加扩展程序宣传信息政策,在 API 代理中使用已配置的扩展程序。政策的配置指定了
    • 要使用的已配置扩展程序。
    • 要调用的扩展程序操作(可将其视为对扩展程序的函数调用)。
    • 要随操作调用一起传递的操作参数。 在运行时,该政策会在代理流程中使用该扩展程序访问外部资源。

关于扩展程序的文档

以下主题介绍了扩展程序的更多信息: