创建键值存储

您可以创建一个空的键值存储，稍后添加键值对。或者，您可以同时创建键值存储及其键值对。

注意

如果您指定来自 Amazon S3 存储桶的数据来源，则必须对该存储桶具有 s3:GetObject 和 s3:GetBucketLocation 权限。如果您没有这些权限，CloudFront 将无法成功创建键值存储。

Console

创建键值存储（控制台）

决定是否要在创建键值存储的同时添加键值对。CloudFront 控制台以及 CloudFront API 和 Amazon SDK 都支持此导入功能。但仅在您最初创建键值存储时，才支持此功能。

如果要使用文件，请立即创建它。
登录到 Amazon Web Services Management Console 并通过以下网址打开 CloudFront 控制台中的函数页面：https://console.amazonaws.cn/cloudfront/v4/home#/functions。
选择 KeyValueStores 选项卡。选择创建 KeyValueStore。
输入键值存储的名称和可选描述。
填写 S3 URI：
- 如果您已事先准备好一个键值对文件，请输入存储该文件的 Amazon S3 存储桶的路径。
- 如果您打算手动输入键值对，请将此字段留空。
选择创建。键值存储现已存在。

此时将显示新键值存储的详细信息页面。页面上的信息包括键值存储的 ID 和 ARN。
- ID 是一个随机字符串，在您的 Amazon 账户中是唯一的。
- ARN 的语法如下：
  
  Amazon Web Services 账户:key-value-store/键值存储 ID
查看键值对部分。如果您导入了文件，则此部分会显示一些键值对。否则为空。您可执行以下操作：
- 如果您没有从 Amazon S3 存储桶导入文件，并且想要立即添加键值对，则可以完成此部分。
- 如果您导入了文件，还可以手动添加更多值。
- 您可以将此部分留空，稍后再通过编辑键值存储来添加键值对。
立即添加键值对：
- 选择添加键值对按钮。
- 选择添加对并输入名称和值。
- 再次选择添加对按钮，以添加更多键值对。
  
  完成后，选择保存更改，将所有键值对保存到键值存储中。在出现的确认对话框中，选择完成。
如果您想立即将键值存储与函数关联，请完成关联的函数部分。您也可以稍后通过此键值存储详细信息页面或函数详细信息页面创建此关联。

要立即创建关联，请选择转至函数按钮。有关更多信息，请参阅创建函数或更新函数。

Programmatically

创建键值存储

决定是否要在创建键值存储的同时添加键值对。（您也可以稍后添加键值对。） CloudFront 控制台以及 CloudFront API 和 SDK 都支持此导入功能。但仅在您最初创建键值存储时，才支持此功能。

如果要使用文件，请立即创建它。
使用 CloudFront API 或您首选的 Amazon SDK 的创建操作。例如，对于 REST API，请使用 CloudFront.CreateKeyValueStore。该操作需要几个参数：
- 名称。
- 包含注释的 configuration 参数。
- 一个 import-source 参数，允许您从存储在 Amazon S3 存储桶中的文件中导入键值对。请注意，只有在初次创建键值存储时，才能从文件导入。有关文件格式的信息，请参阅创建键值对的文件。

操作响应包含以下信息：

请求中传递的值，包括您分配的名称。
诸如创建时间之类的数据。
ETag（例如，ETVABCEXAMPLE2），即包含键值存储名称的 ARN（例如 arn:aws:cloudfront::111122223333:key-value-store/MaxAge）。

您将使用 ETag、ARN 和名称的某种组合以编程方式使用键值存储。

键值存储状态

创建键值存储时，数据存储可以具有以下状态值。

值	描述
预置	键值存储已创建，CloudFront 正在处理您指定的数据来源。
就绪	键值存储已创建，CloudFront 成功处理了您指定的数据来源。
导入失败	CloudFront 无法处理您指定的数据来源。如果您的文件格式无效或超过大小限制，则会显示此状态。有关更多信息，请参阅创建键值对的文件。

Javascript 在您的浏览器中被禁用或不可用。

要使用 Amazon Web Services 文档，必须启用 Javascript。请参阅浏览器的帮助页面以了解相关说明。

使用键值存储

将键值存储与函数相关联