使用 CloudFront HTTP 标头 - Amazon CloudFront
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

使用 CloudFront HTTP 标头

您可以将 CloudFront 配置为根据查看器请求的特征添加特定 HTTP 标头。利用这些标头,您的源可以接收有关查看器的设备类型、地理位置等方面的信息,而无需使用自定义代码来确定此信息。如果源根据这些标头中的信息返回不同的响应,您可以将它们包含在缓存键 中,以便 CloudFront 分别缓存不同的响应。

要在源处接收这些标头,请使用源请求策略。有关更多信息,请参阅控制源请求

要将这些标头包含在缓存键中,请使用缓存策略。有关更多信息,请参阅 控制缓存键了解缓存键

用于确定查看器的设备类型的标头

使用以下标头可确定查看器的设备类型。根据 User-Agent 标头的值,CloudFront 将这些标头的值设置为 truefalse。如果某个设备归入多个类别中,则多个值可能为 true。例如,对于一些平板电脑设备,CloudFront 可能将 CloudFront-Is-Mobile-ViewerCloudFront-Is-Tablet-Viewer 设置为 true

  • CloudFront-Is-Android-Viewer – 当 CloudFront 确定查看器是采用 Android 操作系统的设备时,设置为 true

  • CloudFront-Is-Desktop-Viewer – 当 CloudFront 确定查看器是桌面设备时,设置为 true

  • CloudFront-Is-IOS-Viewer – 当 CloudFront 确定查看器是带 Apple 操作系统的设备时,设置为 true

  • CloudFront-Is-Mobile-Viewer – 当 CloudFront 确定查看器是移动设备时,设置为 true

  • CloudFront-Is-SmartTV-Viewer – 当 CloudFront 确定查看器是智能电视时,设置为 true

  • CloudFront-Is-Tablet-Viewer – 当 CloudFront 确定查看器是平板电脑时,设置为 true

用于确定查看器的位置的标头

使用以下标头可确定查看器的位置。CloudFront 根据查看器的 IP 地址确定这些标头的值。

注意

对于这些标头值中的非 ASCII 字符,CloudFront 百分比将根据 RFC 3986 的第 1.2 部分对字符进行编码。

  • CloudFront-Viewer-City – 包含查看器的城市的名称。

  • CloudFront-Viewer-Country – 包含查看器所在国家/地区的双字母国家/地区代码。有关国家/地区代码的列表,请参阅 ISO 3166-1 alpha-2

  • CloudFront-Viewer-Country-Name – 包含查看器所在国家/地区的名称。

  • CloudFront-Viewer-Country-Region – 包含代表查看器的区域的代码(最多三个字符)。区域是 ISO 3166-2 代码中最具体的细分。

  • CloudFront-Viewer-Country-Region-Name – 包含查看器的区域的名称。区域是 ISO 3166-2 代码中最具体的细分。

  • CloudFront-Viewer-Latitude – 包含查看器的近似纬度。

  • CloudFront-Viewer-Longitude – 包含查看器的近似经度。

  • CloudFront-Viewer-Metro-Code – 包含查看器的都市代码。仅当查看器所在地区是美国时提供此项。

  • CloudFront-Viewer-Postal-Code – 包含查看器的邮政编码。

  • CloudFront-Viewer-Time-Zone 包含查看器的时区,采用 IANA 时区数据库格式(例如, America/Los_Angeles)。

其他 CloudFront 标头

使用以下标头可确定查看器请求的协议和 HTTP 版本。

  • CloudFront-Forwarded-Proto – 包含查看器请求的协议(HTTP 或 HTTPS)。

  • CloudFront-Viewer-Http-Version – 包含查看器请求的 HTTP 版本。