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

如果我们为英文版本指南提供翻译,那么如果存在任何冲突,将以英文版本指南为准。在提供翻译时使用机器翻译。

使用 CloudFront HTTP标头

您可以配置 CloudFront 根据查看器请求的特性添加特定HTTP标头。通过这些标头,您的原始产品可以接收有关查看器设备类型、地理位置等信息的信息,而无需自定义代码来确定此信息。如果您的原始回答根据这些标题中的信息返回不同的回答,您可以将其纳入 缓存密钥 这样 CloudFront 分别缓存不同的答案。

要在您的起始地接收这些标头,请使用 起运地请求政策. 有关更多信息,请参阅 控制起始请求。)

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

确定查看器设备类型的标题

使用以下标题确定查看器设备类型。基于该数值 User-Agent 标题, CloudFront 将这些标题的值设置为 truefalse...如果设备属于多个类别,则可能超过一个值 true...例如,对于一些平板设备, CloudFront 可能会设置 CloudFront-Is-Mobile-ViewerCloudFront-Is-Tablet-Viewertrue.

  • CloudFront-Is-Android-Viewer – 设置为 true 当WhenWhen CloudFront 确定查看器是安卓操作系统的设备。

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

  • CloudFront-Is-IOS-Viewer – 设置为 true 当WhenWhen CloudFront 确定查看器是具有Apple操作系统的设备。

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

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

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

确定查看器位置的标题

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

注意

对于这些标题值中的非ASCII字符, CloudFront %按照 RFC3986的第1.2节.

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

  • CloudFront-Viewer-Country – 包含查看器国家/地区的两个字母国家代码。如需国家代码列表,请参阅 ISO3166-1Alpha-2.

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

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

  • CloudFront-Viewer-Country-Region-Name – 包含查看器区域的名称。该地区是最具体的分部 ISO3166-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版本。