发布函数 - Amazon CloudFront
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅中国的 Amazon Web Services 服务入门。

发布函数

发布函数会将其从 DEVELOPMENT 阶段复制到 LIVE。

重要

发布函数时，与该函数关联的所有缓存行为会在分配完成部署后立即自动开始使用新发布的副本。

如果没有与函数关联的缓存行为，则发布它使您能够将其与缓存行为相关联。您只能将缓存行为与处于 LIVE 阶段中的函数相关联。

您可以在 CloudFront 控制台中或使用 Amazon CLI 发布函数。

Console

要发布函数，您可以使用 CloudFront 控制台。控制台还显示与该函数关联的 CloudFront 分配。

要发布函数（控制台）

  1. 要发布函数，请通过以下网址在 CloudFront 控制台中打开函数页面：https://console.amazonaws.cn/cloudfront/v3/home#/functions，然后选择您想要发布的函数。

  2. 在函数页面上，选择发布选项卡。然后，选择发布按钮（或者，如果您的函数已附加到一个或多个缓存行为，则选择发布并更新按钮。

  3. （可选）要查看与函数关联的分配，请选择关联的 CloudFront 分配以展开该部分。

成功后，您会在页面顶部看到一个横幅，表明函数名称已成功发布。您还可以选择构建选项卡，然后选择实时以查看函数代码的实时版本。

CLI

要发布函数，请使用 Amazon CLI 中的 aws cloudfront publish-function 命令，如以下示例所示。要使用此示例，请执行下列操作：

  • 将 ExampleFunction 替换为您正在发布的函数的名称。

  • 将 ETVXYZEXAMPLE 替换为您正在发布的函数的 ETag 值。要获取此值，您可以使用 aws cloudfront describe-function 命令。

  • 在一行上运行该命令。在示例中，提供换行符以使示例更具可读性。

aws cloudfront publish-function \
    --name ExampleFunction \
    --if-match ETVXYZEXAMPLE

命令成功后，您会看到类似以下内容的输出，其中描述了刚发布的函数。

注意

以下输出格式为 YAML 字符串。此功能只能用于 Amazon CLI 版本 2。有关更多信息，请参阅《Amazon Command Line Interface 用户指南》中的设置 Amazon CLI 输出格式。

FunctionSummary:
  FunctionConfig:
    Comment: Example function
    Runtime: cloudfront-js-1.0
  FunctionMetadata:
    CreatedTime: '2021-04-18T21:24:21.314000+00:00'
    FunctionARN: arn:aws:cloudfront::111122223333:function/ExampleFunction
    LastModifiedTime: '2021-04-19T23:41:15.389000+00:00'
    Stage: LIVE
  Name: ExampleFunction
  Status: UNASSOCIATED