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

创建函数

在创建函数之前，您必须编写函数代码。有关编写函数的更多信息，请参阅编写函数代码（编程模型）。有关可以帮助您入门的示例代码，请参阅示例代码。

当您在 CloudFront Functions 中创建新函数时，该函数处于 DEVELOPMENT 阶段。在此阶段中，您可以测试函数，并在必要时更新函数。当您准备好在 CloudFront 分配中使用函数时，您可以发布函数，该函数会将其从 DEVELOPMENT 阶段复制到 LIVE。当它处于 LIVE 阶段时，您可以将函数与分配的缓存行为关联。

您可以在 CloudFront 控制台中或使用 Amazon Command Line Interface (Amazon CLI) 创建函数。

在控制台中创建函数时，您可以从默认函数开始，从 GitHub 上的示例代码中复制函数，或从头开始创建自己的函数代码。

要创建函数（控制台）

  1. 登录到 Amazon Web Services Management Console 并通过以下网址打开 CloudFront 控制台中的 Functions（函数）页面：https://console.amazonaws.cn/cloudfront/v2/home#/functions。

  2. 选择创建函数。

  3. 输入函数名称，然后选择 Continue（继续）。函数名称在Amazon账户中必须是唯一的。

  4. 在 function 页面上，执行以下操作：

    1. （可选）输入函数的描述。

    2. 修改函数代码。控制台提供了一个默认函数，可以帮助您入门。或者您可以从 GitHub 上的示例代码进行复制。有关编写函数代码的详细信息，请参阅以下内容：

    3. 选择 Save（保存）以保存函数。

成功后，您会在页面顶部看到一个横幅，表明函数名称已成功保存。

保存函数后，您可以对其进行测试。

编写函数代码后，您可以使用 aws cloudfront create-function 命令通过 Amazon CLI 创建函数，如以下示例所示。以下示例命令使用输入文件向 create-function 命令提供函数代码。要使用此示例，请执行下列操作：

  • 将 ExampleFunction 替换为函数的名称。

  • 将 Example function 替换为描述函数的注释。

  • 将 function.js 替换为包含您的函数代码的文件名称。从包含此文件的目录中运行命令。

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

aws cloudfront create-function \
    --name ExampleFunction \
    --function-config Comment="Example function",Runtime="cloudfront-js-1.0" \
    --function-code fileb://function.js

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

注意

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

ETag: ETVABCEXAMPLE
FunctionSummary:
  FunctionConfig:
    Comment: Example function
    Runtime: cloudfront-js-1.0
  FunctionMetadata:
    CreatedTime: '2021-04-18T20:38:56.915000+00:00'
    FunctionARN: arn:aws:cloudfront::111122223333:function/ExampleFunction
    LastModifiedTime: '2021-04-18T20:38:56.915000+00:00'
    Stage: DEVELOPMENT
  Name: ExampleFunction
  Status: UNPUBLISHED
Location: https://cloudfront.amazonaws.com/2020-05-31/function/arn:aws:cloudfront::111122223333:function/ExampleFunction