使文件失效 - Amazon CloudFront
在使文件失效和使用版本控制的文件名之间进行选择确定使哪个文件失效指定要失效的文件使用控制台使文件失效使用 API 使文件失效 CloudFront 并发失效请求最大值支付文件失效费用
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

使文件失效

如果您需要在文件过期之前将其从 CloudFront 边缘缓存中删除，则可以执行以下操作之一：

  • 通过边缘缓存使文件失效。查看器下次请求文件时，CloudFront 将返回源以获取文件的最新版本。

  • 使用文件版本控制以提供具有不同名称的文件的不同版本。有关更多信息，请参阅 使用版本控制的文件名更新现有文件。

要使文件失效，您可以指定单独文件的路径或以 * 通配符结尾的路径，后者可能会应用到一个或多个文件，如以下示例中所示：

  • /images/image1.jpg

  • /images/image*

  • /images/*

注意

如果您使用 Amazon Command Line Interface (Amazon CLI) 使文件失效，并且您指定一个包含 * 通配符的路径，则必须使用引号 (") 将路径引起来。

例如：aws cloudfront create-invalidation --distribution-id distribution_ID --paths "/*"

您每月可免费提交特定数量的失效路径。如果您提交的数量超过了该月中分配的失效路径数，则需要为提交的每个失效路径支付费用。有关使用失效费用的更多信息，请参阅 支付文件失效费用。

在使文件失效和使用版本控制的文件名之间进行选择

要控制从分配提供的文件版本，您可使文件失效或使用版本控制文件名为其命名。如果您希望频繁地更新文件，出于以下原因，我们建议您主要使用文件版本控制：

  • 即使用户在本地或企业缓存代理中缓存了文件的版本，版本控制也使您能够控制为请求返回哪个文件。如果您使文件失效，用户看到的可能继续是旧版本直至它从这些缓存中过期。

  • CloudFront 访问日志包含文件名称，因此版本控制可以更轻松地分析文件更改的结果。

  • 版本控制提供一种将不同版本的文件提供给不同用户的方式。

  • 版本控制简化了文件修订之间的向前和向后滚动。

  • 版本控制更便宜。您仍然需要为 CloudFront 将文件的新版本传输到边缘位置付费，但不必为文件失效付费。

有关文件版本控制的更多信息，请参阅使用版本控制的文件名更新现有文件。

确定使哪个文件失效

如果您要使多个文件失效，例如某个目录中的所有文件或者名称以相同字符开头的所有文件，您可以在失效路径的结尾包含 * 通配符。有关使用 * 通配符的更多信息，请参阅 Invalidation paths。

如果您想使选定文件失效但用户不必访问源上的每个文件，您可确定查看器从 CloudFront 请求了哪些文件并只使这些文件失效。要确定查看者请求了哪些文件，请启用 CloudFront 访问日志记录。有关访问日志的更多信息，请参阅 配置和使用标准日志（访问日志）。

指定要失效的文件

请注意以下有关指定要失效文件的信息。

区分大小写

失效路径区分大小写，因此，/images/image.jpg 和 /images/Image.jpg 指定了两个不同的文件。

使用 Lambda 函数更改 URI

如果您的 CloudFront 分配在查看者请求事件上触发了 Lambda 函数，并且该函数更改了所请求文件的 URI，我们建议您使两个 URI 都失效，以便从边缘缓存中移除该文件： CloudFront

  • 查看器请求中的 URI

  • 函数进行更改后的 URI

例如，假设您的 Lambda 函数将文件的 URI 从以下 URI：

https://d111111abcdef8.cloudfront.net/index.html

更改为包含语言目录的 URI：

https://d111111abcdef8.cloudfront.net/en/index.html

要使文件失效，您必须指定以下路径：

  • /index.html

  • /en/index.html

有关更多信息，请参阅 Invalidation paths。

默认根对象

要使默认根对象（文件）失效，请以您为任何其他文件指定路径相同的方式指定路径。有关更多信息，请参阅原定设置根对象的工作原理。

转发 Cookie

如果您配置为将 Cookie 转发 CloudFront 到您的源，则 CloudFront 边缘缓存可能包含该文件的多个版本。当您使文件失效之后， CloudFront 会使文件的所有缓存版本失效，不论其关联的 Cookie 如何。您无法根据关联的 Cookie 选择性地使一些版本失效，而使另一些版本不失效。有关更多信息，请参阅 根据 Cookie 缓存内容。

转发标头

如果您配置为 CloudFront 将标头列表转发到您的源并根据标头的值进行缓存，则 CloudFront 边缘缓存可能包含该文件的多个版本。使文件失效时，无论标头值如何，都会使该文件的每个缓存版本 CloudFront 失效。您无法根据标头值选择性地使一些版本失效，而使另一些版本不失效。（如果您配置 CloudFront 为将所有标头转发到您的来源，则CloudFront 不会缓存您的文件。） 有关更多信息，请参阅根据请求标头缓存内容。

转发查询字符串

如果您配置为 CloudFront 将查询字符串转发到您的源，则在使文件失效时必须包括查询字符串，如以下示例所示：

  • /images/image.jpg?parameter1=a

  • /images/image.jpg?parameter1=b

如果客户端请求包括针对同一个文件的五个不同查询字符串，您可以使文件失效五次（每个查询字符串一次），或者您可以在失效路径中使用 * 通配符，如下例中所示：

/images/image.jpg*

有关在失效路径中使用通配符的更多信息，请参阅 Invalidation paths。有关查询字符串的更多信息，请参阅 根据查询字符串参数缓存内容。要确定正在使用哪些查询字符串，可以启用 CloudFront 日志记录。有关更多信息，请参阅配置和使用标准日志（访问日志）。

允许的最大值

有关允许的最大失效次数的信息，请参阅并发失效请求最大值。

Microsoft 平滑流文件

为对应的缓存行为启用了平滑流时，您不能使 Microsoft 平滑流格式的媒体文件失效。

路径中的非 ASCII 或不安全字符

如果路径包含非 ASCII 字符或 RFC 1738 中定义的不安全字符，请对这些字符进行 URL 编码。请勿对路径中的任何其他字符进行 URL 编码，否则 CloudFront 不会使更新后的文件的旧版本失效。

失效路径

路径是相对于分配的。例如，要使 https://d111111abcdef8.cloudfront.net/images/image2.jpg 处的文件失效，您可指定以下内容：

/images/image2.jpg

注意

在 CloudFront 控制台中，您可以省略路径中的前导斜杠，如下所示：images/image2.jpg。直接使用 CloudFront API 时，失效路径必须以前导斜杠开头。

您还可以使用 * 通配符使多个文件同时失效。* 将替换 0 个或多个字符，必须是失效路径中最后的字符。此外，如果您使用 Amazon Command Line Interface (Amazon CLI) 使文件失效，并且您指定一个包含 * 通配符的路径，则必须使用引号 (") 将路径引起来（如 "/*"）。

以下是一些示例：

  • 使目录中的所有文件失效：

    /directory-path/*

  • 使目录、其所有子目录以及该目录和子目录中的所有文件失效：

    /directory-path*

  • 使具有相同名称但文件扩展名不同的所有文件失效 (例如 logo.jpg、logo.png 和 logo.gif)：

    /directory-path/file-name.*

  • 使目录中文件名以相同字符开头的所有文件失效 (例如 HLS 格式的视频的所有文件) 而不论扩展名如何：

    /目录路径-名称 / initial-characters-in-file *

  • 当您配置 CloudFront 为基于查询字符串参数进行缓存并且想要使文件的每个版本都失效时：

    /directory-path/file-name.file-name-extension*

  • 使分配中的所有文件失效：

    /*

路径的长度上限是 4000 个字符。您不能在路径内使用通配符；只能在路径终点处使用。

有关使用 Lambda 函数更改 URI 时使文件失效的信息，请参阅Changing the URI Using a Lambda Function。

不论您要使之失效的文件的数量是多少（单个文件 (/images/logo.jpg) 或是与分配关联的所有文件 (/*)），提交失效路径的费用均相同。有关更多信息，请参阅 Amazon CloudFront 定价。

如果失效路径为目录且您对指定目录的方法尚未标准化 (带或不带尾部斜杠 /)，我们建议您使带和不带尾部斜杠的目录均失效，例如，/images 和 /images/。

已签名的 URL

如果您正在使用签名 URL，可以通过在问号 (?) 前仅包括部分 URL 来使文件失效。

使用控制台使文件失效

您可以使用 CloudFront 控制台来创建和运行失效，显示您之前提交的失效列表以及显示有关单个失效的详细信息。您还可复制现有的失效、编辑文件路径列表并运行已编辑的失效。您无法从列表中删除失效。

使文件失效

要使用 CloudFront 控制台使文件失效，请执行以下操作。

使文件失效

  1. 登录Amazon Web Services Management Console并打开 CloudFront 控制台，网址为https://console.amazonaws.cn/cloudfront/v4/home。

  2. 选择您想为其使文件失效的分配。

  3. 选择分配设置。

  4. 选择失效选项卡。

  5. 选择创建失效。

  6. 对于您希望使其失效的文件，请在每行输入一个失效路径。有关指定失效路径的信息，请参阅 指定要失效的文件。

    重要

    请谨慎指定文件路径。在启动之后，您无法取消失效请求。

  7. 选择失效。

复制、编辑及重新运行现有失效

您可复制您先前创建的失效、更新失效路径列表以及运行已更新的失效。您不可复制现有失效、更新失效路径，然后在不运行已更新失效的情况下将其保存。

重要

如果您复制的失效仍在进行中，请更新失效路径列表，然后运行更新的失效， CloudFront 不会停止或删除您复制的失效。如果原始文件和副本中出现任何失效路径， CloudFront 将尝试使文件失效两次，两次失效都将计入您当月免费失效的最大次数。如果您已达到免费失效的最大数目，将会向您收取每个文件两次失效的费用。有关更多信息，请参阅 并发失效请求最大值。

复制、编辑及重新运行现有失效

  1. 登录Amazon Web Services Management Console并打开 CloudFront 控制台，网址为https://console.amazonaws.cn/cloudfront/v4/home。

  2. 选择包含要复制的失效的分配。

  3. 选择分配设置。

  4. 选择失效选项卡。

  5. 选择您想复制的失效。

    如果您不确定要复制哪个失效，您可选择某个失效，然后选择 Details (详细信息) 以显示该失效的详细信息。

  6. 选择 Copy。

  7. 更新失效路径列表 (如适用)。

  8. 选择失效。

取消失效

当您向提交失效请求时 CloudFront，会在几秒钟内将该请求 CloudFront 转发到所有边缘站点，每个边缘站点都会立即开始处理失效请求。因此，一旦提交失效便无法取消它。

列出失效

您可以使用控制台显示您在分配中创建和运行的最近 100 个失效的列表。 CloudFront 如果您想获得超过 100 个失效的列表，请使用 ListInvalidations API 操作。有关更多信息，请参阅 Amazon CloudFront API 参考ListInvalidations中的。

列出失效

  1. 登录Amazon Web Services Management Console并打开 CloudFront 控制台，网址为https://console.amazonaws.cn/cloudfront/v4/home。

  2. 选择您要为其显示失效列表的分配。

  3. 选择分配设置。

  4. 选择失效选项卡。

注意

您无法从列表中删除失效。

显示有关失效的信息

您可显示失效的详细信息，包括分配 ID、失效 ID、失效状态、创建失效的日期和时间以及完整的失效路径列表。

显示有关失效的信息

  1. 登录Amazon Web Services Management Console并打开 CloudFront 控制台，网址为https://console.amazonaws.cn/cloudfront/v4/home。

  2. 选择包含您要为其显示详细信息的失效的分配。

  3. 选择分配设置。

  4. 选择失效选项卡。

  5. 选择适用的失效。

  6. 选择 Details。

使用 API 使文件失效 CloudFront

有关使对象失效以及如何使用 API 显示失效信息的信息，请参阅 Amazon CloudFront API 参考中的以下主题： CloudFront

并发失效请求最大值

如果您想逐个让文件失效，则针对每个分配一次可以同时处理 3000 个文件的无效请求。一个无效请求可以支持最多 3000 个文件，或针对一个文件的 3000 个请求，或者合计不超过 3000 个文件的任何组合方式。例如，您可以提交 30 个失效请求，每个请求使 100 个文件失效。只要全部 30 个失效请求仍在进行中，您无法继续提交任何失效请求。如果超过最大值，则 CloudFront 返回错误消息。

如果您使用 * 通配符，则一次最多可以提出 15 个无效路径请求。您一次可以为每个分配的最多 3000 个单独文件提出失效请求，而允许的通配符无效请求的最大值与个别使文件失效的最大值无关。

支付文件失效费用

您每月提交的前 1000 个失效路径免费；每月超过 1000 个之后，您须为每个失效路径支付费用。一个失效路径可以针对单个文件（如 /images/logo.jpg），也可针对多个文件（如 /images/*）。包含*通配符的路径算作一个路径，即使它会 CloudFront 导致成千上万个文件失效。

每月 1000 个免费失效路径的最大值适用于您用一个 Amazon 账户创建的所有分配的失效路径总数。例如，如果您使用 Amazon 账户 john@example.com 创建三个分配，并在指定月份里为每个分配提交 600 个失效路径 (总共 1800 个失效路径)，则 Amazon 在该月将向您收取 800 个失效路径的费用。有关失效定价的具体信息，请参阅 Amazon CloudFront 定价。有关失效路径的更多信息，请参阅 Invalidation paths。