Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅
中国的 Amazon Web Services 服务入门
(PDF)。
创建函数
在创建函数之前,您必须编写函数代码。有关编写函数的更多信息,请参阅编写函数代码(编程模型)。有关可以帮助您入门的示例代码,请参阅示例代码。
当您在 CloudFront Functions 中创建新函数时,该函数处于 DEVELOPMENT
阶段。在此阶段中,您可以测试函数,并在必要时更新函数。当您准备好在 CloudFront 分配中使用函数时,您可以发布函数,该函数会将其从 DEVELOPMENT
阶段复制到 LIVE
。当它处于 LIVE
阶段时,您可以将函数与分配的缓存行为关联。
您可以在 CloudFront 控制台中或使用 Amazon Command Line Interface (Amazon CLI) 创建函数。
- Console
-
在控制台中创建函数时,您可以从默认函数开始,从 GitHub 上的示例代码中复制函数,或从头开始创建自己的函数代码。
成功后,您会在页面顶部看到一个横幅,表明函数名称
已成功保存。
保存函数后,您可以对其进行测试。
- CLI
-
编写函数代码后,您可以使用 Amazon CLI 命令通过 aws cloudfront create-function 创建函数,如以下示例所示。以下示例命令使用输入文件向 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
命令成功后,您会看到类似以下内容的输出,其中描述了刚创建的函数。
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