建立函數

您可以分兩個階段建立函式：

1. 將函數代碼創建為 JavaScript。您可以使用 CloudFront 控制台中的默認示例，也可以編寫自己的示例。如需詳細資訊，請參閱下列主題：

   • 撰寫函數程式碼

   • CloudFront 函數事件結構

   • CloudFront 函數的範例程式碼

2. 用 CloudFront 於建立函數並包含您的程式碼。程式碼存在於函數內部 (而不是引用形式)。

Console

建立 函數

1. 登入 CloudFront 主控台，https://console.aws.amazon.com/cloudfront/v4/home#/functions然後選擇「功能」頁面。

2. 選擇建立函數。

3. 輸入在中唯一的函數名稱 AWS 帳戶，選擇 JavaScript 版本，然後選擇繼續。新函數的詳細資訊頁面會隨即顯示。

   注意

   若要在函數中使用索引鍵值配對，您必須選擇 JavaScript 執行階段 2.0。

4. 在 [函數程式碼] 區段中，選擇 [建置] 索引標籤，然後輸入函數程式碼。建置索引標籤中包含的範例程式碼會說明函數程式碼的基本語法。

5. 選擇儲存變更。

6. 如果函數代碼使用鍵值對，則必須關聯索引鍵值存放區。

   您可以在第一次建立函數時關聯索引鍵值存放區。或者，您可以稍後更新函數來關聯它。

   若要立即關聯鍵值存放區，請依照下列步驟執行：

   • 移至「關聯」 KeyValueStore 區段，然後選擇「關聯現有」 KeyValueStore。

   • 選取函數中包含索引鍵值配對的索引鍵值存放區，然後選擇「關聯 KeyValueStore」。

   CloudFront 立即將商店與該功能相關聯。您無需儲存函數。

CLI

如果您使用 CLI，通常會先在檔案中建立函數程式碼，然後使用 AWS CLI來建立函數。

建立 函數

1. 在檔案中建立函數程式碼，並將其儲存於電腦可以連線的目錄中。

2. 執行命令，如範例所示。此範例會使用fileb://符號來傳入檔案。它還會包括換行符號，讓命令更易於讀取。

   aws cloudfront create-function \
       --name MaxAge \
       --function-config '{"Comment":"Max Age 2 years","Runtime":"cloudfront-js-2.0","KeyValueStoreAssociations":{"Quantity":1,"Items":[{"KeyValueStoreARN":"arn:aws:cloudfront::111122223333:key-value-store/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"}]}}' \
       --function-code fileb://function-max-age-v1.js
   

   備註

   • Runtime— 的版本 JavaScript. 若要在函數中使用索引鍵值配對，您必須指定 2.0 版。

   • KeyValueStoreAssociations— 如果您的函數使用鍵值對，則可以在第一次建立函數時關聯索引鍵值存放區。或者，您可以稍後使用來關聯它update-function。Quantity 永遠等於 1，因為每個函數只能有一個與其關聯的鍵值存放區。

   如果命令成功執行，您會看到如下所示的輸出。

   ETag: ETVABCEXAMPLE
   FunctionSummary:
     FunctionConfig:
       Comment: Max Age 2 years
       Runtime: cloudfront-js-2.0
       KeyValueStoreAssociations= \
         {Quantity=1, \
         Items=[{KeyValueStoreARN='arn:aws:cloudfront::111122223333:key-value-store/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111'}]} \
     FunctionMetadata:
       CreatedTime: '2021-04-18T20:38:56.915000+00:00'
       FunctionARN: arn:aws:cloudfront::111122223333:function/MaxAge
       LastModifiedTime: '2023-11-19T20:38:56.915000+00:00'
       Stage: DEVELOPMENT
     Name: MaxAge
     Status: UNPUBLISHED
   Location: https://cloudfront.amazonaws.com/2020-05-31/function/arn:aws:cloudfront:::function/MaxAge

   大多數資訊都是從請求中複製的。其他資訊由新增 CloudFront。

   備註

   • ETag— 每次修改金鑰值存放區時，此值都會變更。您可以使用此值和函數名稱來引用 future 的函數。確保您始終使用當前的ETag。

   • FunctionARN— 您的 CloudFront功能的 ARN。

   • 111122223333 — 該. AWS 帳戶

   • Stage— 函數 (LIVE或DEVELOPMENT) 的階段。

   • Status— 函數 (PUBLISHED或UNPUBLISHED) 的狀態。

建立函數之後，它就會新增至DEVELOPMENT舞台。我們建議您先測試您的函數，然後再發佈它。發佈函數之後，函數會變更為LIVE階段。