您正在查看 Apigee Edge 文档。
前往 Apigee X 文档。 信息
您可以使用扩展程序将外部资源集成到 API 代理中。例如,您可以集成 Google Cloud Storage 等 Google Cloud Platform 服务。在运行时,API 代理使用该扩展程序与外部资源交换请求和响应。
扩展程序运行时框架
在运行时,扩展程序充当中介,处理 API 代理与外部资源之间的请求和响应。
下面简要介绍了通过扩展程序在运行时进行处理的工作原理。
- 客户端请求到达 API 代理,其请求流程会按照代理的政策继续进行。
- 请求流会到达代理中的扩展程序宣传信息政策,该政策配置为将数据传递给部署在环境中的扩展程序。这些数据包含向扩展程序代表的外部资源发送请求所需的值。
- 扩展程序向外部资源发送请求,然后接收响应。
- 扩展程序会将其响应传回给“扩展程序宣传信息”政策,由代理代码进行处理。
- 请求流会继续通过代理,直到代理向客户端返回响应。
使用扩展程序
每个扩展程序的开发和配置都以特定的外部资源为依据。如需使用扩展程序,Apigee Edge 管理员和 API 代理开发者需要按照以下大致步骤操作:
- Apigee Edge 组织管理员配置并部署该扩展程序。他们会使用特定于业务需求的值对其进行配置。此配置会创建一个扩展程序实例,供 API 代理开发者使用。例如,他们可以配置扩展程序以访问 Google Cloud Storage 中的特定存储分区,包括所需的身份验证凭据。
- API 代理开发者可以通过向代理添加扩展程序宣传信息政策,在 API 代理中使用已配置的扩展程序。政策的配置指定了
- 要使用的已配置扩展程序。
- 要调用的扩展程序操作(可将其视为对扩展程序的函数调用)。
- 要随操作调用一起传递的操作参数。 在运行时,该政策会在代理流程中使用该扩展程序访问外部资源。
关于扩展程序的文档
以下主题介绍了扩展程序的更多信息:
- 如需对扩展程序进行实操介绍,请参阅教程:添加和使用扩展程序。
- 如需参考 Apigee Edge 附带的扩展程序,请参阅扩展程序参考概览。
- 如需查看可用于添加、移除和部署扩展程序的管理 API 参考文档,请参阅 Extensions API。