# 使文件失效
<a name="Invalidation_Requests"></a>

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

**Contents**
+ [使文件失效](#invalidating-objects-console)
+ [复制、编辑和重新运行现有失效](#invalidating-objects-copy-console)
+ [取消失效](#canceling-invalidations)
+ [列出失效](#listing-invalidations-console)
+ [显示有关失效的信息](#invalidation-details-console)

## 使文件失效
<a name="invalidating-objects-console"></a>

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

------
#### [ Console ]<a name="invalidating-objects-console-procedure"></a>

**使文件失效（控制台）**

1. 登录 AWS 管理控制台，并通过以下网址打开 CloudFront 控制台：[https://console.aws.amazon.com/cloudfront/v4/home](https://console.aws.amazon.com/cloudfront/v4/home)。

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

1. 选择**失效**选项卡。

1. 选择**创建失效**。

1. 对于您希望使其失效的文件，请在每行输入一个失效路径。有关指定失效路径的信息，请参阅 [使文件失效时的需知事项](invalidation-specifying-objects.md)。
**重要**  
请谨慎指定文件路径。在启动之后，您无法取消失效请求。

1. 选择**创建失效**。

------
#### [ CloudFront API ]

要了解如何使对象失效以及显示失效相关信息，请参阅《Amazon CloudFront API 参考》**中的以下主题：
+ [CreateInvalidation](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_CreateInvalidation.html) 
+ [ListInvalidations](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_ListInvalidations.html)
+ [GetInvalidation](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_GetInvalidation.html)

**注意**  
如果您使用 AWS Command Line Interface（AWS CLI）使文件失效，并且指定了一个包含 `*` 通配符的路径，则必须使用引号（`"`）将路径引起来，如以下所示：  

```
aws cloudfront create-invalidation --distribution-id distribution_ID --paths "/*"
```

------

## 复制、编辑和重新运行现有失效
<a name="invalidating-objects-copy-console"></a>

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

**重要**  
如果您复制仍在进行中的失效、更新失效路径列表，然后运行已更新的失效，则 CloudFront 不会停止或删除您复制的失效。如果任何失效路径出现在原本和副本中，CloudFront 将尝试使文件失效两次，且两次失效均计入到您每月免费失效的最大数目中。如果您已经达到了免费失效的最大数目，将会向您收取每个文件两次失效的费用。有关更多信息，请参阅 [并发失效请求最大值](InvalidationLimits.md)。<a name="invalidating-objects-copy-console-procedure"></a>

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

1. 登录 AWS 管理控制台，并通过以下网址打开 CloudFront 控制台：[https://console.aws.amazon.com/cloudfront/v4/home](https://console.aws.amazon.com/cloudfront/v4/home)。

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

1. 选择**失效**选项卡。

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

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

1. 选择**复制到新项目**。

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

1. 选择**创建失效**。

## 取消失效
<a name="canceling-invalidations"></a>

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

## 列出失效
<a name="listing-invalidations-console"></a>

通过使用 CloudFront 控制台，您可显示您已为分配创建和运行的最后 100 个失效的列表。如果您想获得超过 100 个失效的列表，请执行 `ListInvalidations` API 操作。有关更多信息，请参阅《Amazon CloudFront API 参考》**中的 [ListInvalidations](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_ListInvalidations.html)。<a name="listing-invalidations-console-procedure"></a>

**列出失效**

1. 登录 AWS 管理控制台，并通过以下网址打开 CloudFront 控制台：[https://console.aws.amazon.com/cloudfront/v4/home](https://console.aws.amazon.com/cloudfront/v4/home)。

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

1. 选择**失效**选项卡。

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

## 显示有关失效的信息
<a name="invalidation-details-console"></a>

您可显示失效的详细信息，包括分配 ID、失效 ID、失效状态、创建失效的日期和时间以及完整的失效路径列表。<a name="invalidation-details-console-procedure"></a>

**显示有关失效的信息**

1. 登录 AWS 管理控制台，并通过以下网址打开 CloudFront 控制台：[https://console.aws.amazon.com/cloudfront/v4/home](https://console.aws.amazon.com/cloudfront/v4/home)。

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

1. 选择**失效**选项卡。

1. 选择适用的失效 ID 或选择失效 ID，然后选择**查看详细信息**。