

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

# 管理缓存键 Cookie
<a name="cache-key-cookies"></a>

将应用程序部署到 Amplify 时，您可以选择是在缓存键中包含还是排除 Cookie。在 Amplify 控制台中，使用**缓存键设置**切换开关，在**自定义标头和缓存**页面上指定此设置。有关说明，请参阅[在缓存键中包含或排除 Cookie](#set-cache-key-cookies)。

**在缓存键中包含 Cookie**  
使用此设置，Amplify 会根据所提供的内容类型，自动为您的应用程序选择最佳缓存配置。必须明确选择这种缓存配置类型。  
如果您使用的是 SDKs 或 AWS CLI，则此设置对应于使用`CreateApp`或`AMPLIFY_MANAGED`的设置`cacheConfig.type``UpdateApp` APIs。

**在缓存键中排除 Cookie**  
这是默认缓存配置。此缓存配置类似于 `AMPLIFY_MANAGED` 配置，不同之处在于它会从缓存键中排除所有 Cookie。  
选择从缓存键中排除 Cookie 可以提高缓存性能。但在选择此缓存配置之前，请务必考虑您的应用程序是否使用 Cookie 来提供动态内容。  
如果您使用 SDKs 或 AWS CLI，则此设置对应于`AMPLIFY_MANAGED_NO_COOKIES`使用`CreateApp`或`cacheConfig.type`将设置为`UpdateApp` APIs。

有关缓存密钥的更多信息，请参阅 *Amazon CloudFront 开发者指南中的[了解缓存密钥](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/understanding-the-cache-key.html)；*。

## 在缓存键中包含或排除 Cookie
<a name="set-cache-key-cookies"></a>

你可以在 Amplify 控制台中为应用程序设置缓存密钥 cookie 配置 SDKs，或者。 AWS CLI

使用以下步骤，通过 Amplify 控制台指定在部署新应用程序时，是在缓存键中包含还是排除 Cookie。

**将应用程序部署到 Amplify 时设置缓存键 Cookie 配置**

1. 登录 AWS 管理控制台 并打开 [Amplify](https://console.aws.amazon.com/amplify/) 控制台。

1. 在**所有应用程序**页面中，选择**创建新应用程序**。

1. 在**开始使用 Amplify 进行构建**页面中选择您的 Git 存储库提供商，然后选择**下一步**。

1. 在**添加存储库分支**页面上，执行以下操作：

   1. 选择需要连接的存储库的名称。

   1. 选择需要连接的存储库分支的名称。

   1. 选择**下一步**。

1. 如果应用程序需要 IAM 服务角色，您可以允许 Amplify Hosting 计算自动为您创建服务角色，也可以指定您已创建的角色。
   + 允许 Amplify 自动创建角色并将其附加到您的应用程序的方法：

     1. 请选择**创建和使用新的服务角色**。
   + 附加您之前创建的服务角色的方法：

     1. 选择**使用现有服务角色**。

     1. 从列表中选择需要使用的角色。

1. 选择**高级设置**，然后找到**缓存键设置**部分。

1. 选择**在缓存键中保留 Cookie** 或**从缓存键中删除 Cookie**。以下屏幕截图显示了控制台中的**缓存键设置**切换开关。  
![\[Amplify 控制台中的缓存键设置切换开关的屏幕截图。\]](http://docs.aws.amazon.com/zh_cn/amplify/latest/userguide/images/amplify-caching-1.png)

1. 选择**下一步**。

1. 在**查看**页面上，选择**保存并部署**。

## 更改应用程序的缓存键 Cookie 配置
<a name="change-cache-cookies"></a>

您可以为已部署到 Amplify 的应用程序更改缓存键 Cookie 配置。使用以下步骤，通过 Amplify 控制台更改是在缓存键中包含还是排除 Cookie。

**更改已部署应用程序的缓存键 Cookie 配置的方法**

1. 登录 AWS 管理控制台 并打开 [Amplify](https://console.aws.amazon.com/amplify/) 控制台。

1. 在**所有应用程序**页面上，选择要更新的应用程序。

1. 在导航窗格中依次选择**托管**和**自定义标头和缓存**。

1. 在**自定义标头和缓存**页面上，找到**缓存键设置**部分，然后选择**编辑**。

1. 选择**在缓存键中保留 Cookie** 或**从缓存键中删除 Cookie**。以下屏幕截图显示了控制台中的**缓存键设置**切换开关。  
![\[Amplify 控制台中的缓存键设置切换开关的屏幕截图。\]](http://docs.aws.amazon.com/zh_cn/amplify/latest/userguide/images/amplify-caching-1.png)

1. 选择**保存**。