可以触发 Lambda@Edge 函数的 CloudFront 事件
对于 Amazon CloudFront 分配中的每个缓存行为,您最多可添加四个触发器(关联),以便在发生特定 CloudFront 事件时触发 Lambda 函数执行。CloudFront 触发器可以基于四个 CloudFront 事件之一,如下图所示。
可用于触发 Lambda@Edge 函数的 CloudFront 事件如下所示:
- 查看器请求
-
当 CloudFront 收到查看器的请求时及它检查请求的对象是否在 CloudFront 缓存中之前,该函数会执行。
在以下情况下该函数不会执行:
-
当获取自定义错误页面时。
-
当 CloudFront 自动将 HTTP 请求重定向到 HTTPS 时(当 查看器协议策略 的值为将 HTTP 重定向到 HTTPS 时)。
-
- 源请求
-
仅当 CloudFront 将请求转发给您的源时,该函数才会执行。当请求的对象位于 CloudFront 缓存中时,该函数不会执行。
- 源响应
-
在 CloudFront 收到来自源的响应之后及它将对象缓存在响应中之前,该函数会执行。请注意,即使从源返回了错误,该函数仍会执行。
在以下情况下该函数不会执行:
-
当请求的文件位于 CloudFront 缓存中并且未过期时。
-
当从由源请求事件触发的函数中生成响应时。
-
- 查看器响应
-
在将请求的文件返回到查看器之前,该函数会执行。请注意,无论文件是否已在 CloudFront 缓存中,该函数都会执行。
在以下情况下该函数不会执行:
-
当源返回 400 或更高的 HTTP 状态代码时。
-
当返回自定义错误页面时。
-
当从由查看器请求事件触发的函数中生成响应时。
-
当 CloudFront 自动将 HTTP 请求重定向到 HTTPS 时(当 查看器协议策略 的值为将 HTTP 重定向到 HTTPS 时)。
-
当对同一个缓存行为添加多个触发器时,您可以使用它们运行同一个函数或对每个触发器运行不同的函数。也可以将同一个函数与多个分配关联。
注意
当 CloudFront 事件触发 Lambda 函数的执行时,该函数必须完成,然后 CloudFront 才能继续。
例如,如果 Lambda 函数被某个 CloudFront 查看器请求事件触发,则在 Lambda 函数完成运行之前,CloudFront 不会将响应返回给查看器或将请求转发到源。
这意味着触发 Lambda 函数的每个请求均会增加请求的延迟,因此您可能希望该函数尽快执行。