您正在查看 Apigee Edge 文档。
前往 Apigee X 文档。 信息
您可以使用扩展程序将外部资源集成到 API 代理中。例如,您可以集成 Google Cloud Storage 等 Google Cloud Platform 服务。在运行时,API 代理会使用扩展程序与外部资源交换请求和响应。
扩展程序运行时框架
在运行时,扩展程序充当中间人,处理 API 代理与外部资源之间的请求和响应。

下面简要介绍了在运行时通过扩展程序进行处理的运作方式。
- 客户端请求到达 API 代理,其请求流会通过代理的政策。
- 请求流到达代理中的 Extension Callout 政策,该政策配置为将数据传递给部署在环境中的扩展程序。该数据包含向扩展程序所代表的外部资源发送请求所需的值。
- 扩展程序向外部资源发送请求,然后接收响应。
- 扩展程序将其响应传递回扩展程序 callout 政策,该政策由代理代码处理。
- 请求流继续通过代理,直到代理向客户端返回响应。
使用扩展程序
每个扩展程序在开发和配置时都考虑到了特定的外部资源。如需使用扩展程序,Apigee Edge 管理员和 API 代理开发者需要按以下大致步骤操作:
- Apigee Edge 组织管理员配置并部署扩展程序。他们会根据业务需求配置具体的值。此配置会创建一个扩展实例,供 API 代理开发者使用。例如,他们可能会配置扩展程序以访问 Google Cloud Storage 中的特定存储分区,包括所需的身份验证凭据。
- API 代理开发者通过向代理添加扩展程序调用政策,在 API 代理中使用已配置的扩展程序。政策的配置指定了
- 使用哪个已配置的扩展服务。
- 要调用的扩展操作(可将其视为对扩展程序的函数调用)。
- 要随操作调用传递的操作参数。 在运行时,该政策会使用扩展程序来访问外部资源,作为代理流程的一部分。
关于扩展程序的文档
以下主题提供了有关扩展程序的更多信息:
- 如需了解有关扩展程序的实践性介绍,请参阅教程:添加和使用扩展程序。
- 如需查看 Apigee Edge 随附的扩展程序的参考文档,请参阅扩展程序参考文档概览。
- 如需查看可用于添加、移除和部署扩展程序的管理 API 的相关参考文档,请参阅扩展程序 API。