创建函数
在创建函数之前,您必须编写函数代码。有关编写函数的更多信息,请参阅编写函数代码(编程模型)。有关可以帮助您入门的示例代码,请参阅示例代码。
当您在 CloudFront Functions 中创建新函数时,该函数处于 DEVELOPMENT
阶段。在此阶段中,您可以测试函数,并在必要时更新函数。当您准备好在 CloudFront 分配中使用函数时,您可以发布函数,该函数会将其从 DEVELOPMENT
阶段复制到 LIVE
。当它处于 LIVE
阶段时,您可以将函数与分配的缓存行为关联。
您可以在 CloudFront 控制台中或使用 Amazon Command Line Interface (Amazon CLI) 创建函数。
- Console
-
在控制台中创建函数时,您可以从默认函数开始,从 GitHub 上的示例代码
中复制函数,或从头开始创建自己的函数代码。 要创建函数(控制台)
-
登录到Amazon Web Services Management Console并通过以下网址打开 CloudFront 控制台中的函数页面:https://console.amazonaws.cn/cloudfront/v3/home#/functions
。 -
选择创建函数。
-
输入函数名称,然后选择继续。函数名称在 Amazon 账户中必须是唯一的。
-
在函数页面上,执行以下操作:
-
(可选)输入函数的描述。
-
修改函数代码。控制台提供了一个默认函数,可以帮助您入门。或者您可以从 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
命令成功后,您会看到类似以下内容的输出,其中描述了刚创建的函数。
注意 以下输出格式为 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
-