通用辅助方法 - Amazon CloudFront
edgeLocation 元数据rawQueryString() 方法
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

通用辅助方法

本页面提供了 CloudFront Functions 中的其他辅助方法。要使用这些方法，请使用 JavaScript 运行时 2.0 创建 CloudFront 函数。

import cf from 'cloudfront';

有关更多信息，请参阅适用于 CloudFront Functions 的 JavaScript 运行时系统 2.0 特征。

edgeLocation 元数据

此方法需要使用 cloudfront 模块。

注意

您只能将此方法用于查看器-请求函数。对于查看器-响应函数，此方法为空。

使用此 JavaScript 对象可获取边缘站点机场代码、预期的区域边缘缓存区域，或用于处理请求的 CloudFront 服务器 IP 地址。此元数据仅在查看器请求事件触发时可用。

cf.edgeLocation = {
    name: SEA
    serverIp: 1.2.3.4
    region: us-west-2
}

cf.edgeLocation 对象可包含：

name

处理请求的边缘站点的三字母 IATA 代码。

serverIp

处理请求的服务器的 IPv4 或 IPv6 地址。

region

发生缓存未命中时请求预计会使用的 CloudFront 区域边缘缓存（REC）。如果预期的 REC 不可用且请求使用备用 REC，则不会更新此值。这不包括正在使用的源护盾位置，除非主 REC 和源护盾的位置相同。

注意

如果 CloudFront 已配置为使用源失效转移，则不会再次调用 CloudFront Functions。有关更多信息，请参阅通过 CloudFront 源失效转移来优化高可用性。

rawQueryString() 方法

此方法不需要 cloudFront 模块。

使用 rawQueryString() 方法可以字符串形式检索未解析和未更改的查询字符串。

请求

function handler(event) {
    var request = event.request;
    const qs = request.rawQueryString();
}

响应

以不带前导 ? 的字符串值形式返回传入请求的完整查询字符串。

  • 如果没有查询字符串，但存在 ?，则函数将返回一个空字符串。

  • 如果没有查询字符串且 ? 不存在，则函数将返回 undefined。

场景 1：返回完整查询字符串（不带前导 ?）

传入请求 URL：https://example.com/page?name=John&age=25&city=Boston

rawQueryString() 返回："name=John&age=25&city=Boston"

场景 2：返回空字符串（当 ? 存在但没有参数时）

传入请求 URL：https://example.com/page?

rawQueryString() 返回：""

场景 3：返回 undefined（无查询字符串和 ?）

传入请求 URL：https://example.com/page

rawQueryString() 返回：undefined