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