服务对象与地域限制
PuppyIP 仅面向海外合规企业及其授权人员提供服务,不面向中国大陆地区开放或提供代理服务。本服务仅限用于中国大陆境外的合法业务活动,严禁在中国大陆境内使用本服务。
代理 IP 或服务器位于境外,不改变上述限制。不得通过中转、转接、共享或转售向中国大陆境内的最终使用者提供本服务。使用前请阅读用户服务协议。
本文要点
- 要求 JavaScript runtime 2.0,支持 viewer request 和 viewer response 函数。
- 在 handler 中提供以斜线开头的路径和已配置的 originId。
- 每次执行两种方法合计只能调用一次,请求和响应正文各有 10 KB 上限。
- 控制台 Test 和 TestFunction 不执行真实网络调用。
先核对源站和函数运行方式
AWS 11 月 18 日宣布支持这项能力。按开发者指南,使用 JavaScript runtime 2.0,从 cloudfront 导入 cf,在 viewer request 或 viewer response 的 handler 内发起调用。请求使用路径和 originId;originId 对应该分配的现有源站。不要把外部主机的完整 URL 填作路径。
使用现有源站意味着 CloudFront 会沿用适用的源站访问控制、VPC 源站及其他已配置的连接设置。函数网络调用有独立的 1 秒超时,源站本身配置的更长响应时间不会延长这一限制。Connection Functions 与使用连续部署的分配不支持该能力。
什么时候用 cf.fetch,什么时候用 cf.beacon
如果当前响应需要读取源站返回的结果,例如读取一个短状态后决定后续处理,可以使用 cf.fetch 并检查返回状态。调用放在面向访客的请求链路上,应先定义超时、源站故障和异常响应时的处理方式。每次调用只有一次机会,别在同一次执行里再调用另一种方法作为回退。
如果只需发送可容忍丢失的遥测,可用 cf.beacon。它立即返回,后续交付失败不会回传给当前函数。需要观测时按文档开启 logDeliveryErrors 并查看 CloudWatch Logs。必须交付的任务应放在有持久队列或可重试的流程里。
按请求往返时间和正文上限核算
AWS 将 1 秒定义为从发送请求到收完最后一个字节。每次函数执行合计最多一次网络调用,请求和响应正文分别最多 10 KB,响应正文不支持流式读取。CloudFront 不缓存这些网络调用的响应。若每次命中该函数分支都调用源站,应按实际分支命中量估算源站负载。
例如,静态响应只需偶尔报告访问事件时,可以对可丢失的遥测做采样,再决定是否发 beacon。若业务每次都要读取一个很少变化的值,先查该值是否适合放入 CloudFront KeyValueStore,再决定是否在每个请求里等待源站。
区分功能测试、实际调用和费用
控制台 Test 和 TestFunction API 中出现网络调用不可用的 TypeError,是 AWS 文档说明的测试限制。可以在函数单测里验证正常响应、超时和异常输入时的分支,再在自己管理的独立测试分配上验证真实调用。记录客户端结果、源站状态和延迟后,再评估是否接入正式流量。
AWS 公告的按量价格是每百万次网络调用 0.10 美元,另计 CloudFront Functions 调用费。CloudFront 固定费率方案 Pro 及以上包含此功能而不单收网络调用费,Free 固定费率方案不支持。核对实际分配所用方案,并按当前价格页和账单计算。
资料来源
常见问题
同一次函数执行能先 fetch,再 beacon 吗?
不能。两者共享每次执行一次网络调用的配额。可以决定当前分支使用哪一种,把另外的工作留给独立流程。
把源站超时调到 5 秒有用吗?
函数网络调用仍以 1 秒为限,从发送请求计到收到最后一个字节。
控制台测试通过能证明生产会连上源站吗?
控制台不会执行该网络调用。还要在受控测试分配上观察函数请求、源站结果和异常分支。