使用請求和回應 - Amazon CloudFront
使用原始容錯移轉的功能在請求觸發器中產生HTTP回應更新HTTP原始響應觸發器中的響應選擇包含主體選項以存取要求主體

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

使用請求和回應

若要使用 Lambda @Edge 請求和回應，請參閱下列主題：

將 Lambda @Edge 函數搭配原始容錯移轉

您可以將 Lambda @Edge 函數與原始群組設定的 CloudFront 發佈搭配使用，例如針對您設定的原始容錯移轉，以協助確保高可用性。若要使用 Lambda 函數與原始伺服器群組搭配，請在您建立快取行為時針對原始伺服器群組觸發的原始伺服器請求或原始伺服器回應中指定函數。

如需詳細資訊，請參閱下列內容：

在請求觸發器中產生HTTP回應

CloudFront 收到請求時，您可以使用 Lambda 函數產生直接 CloudFront 傳回給檢視器的回應，而無需將回應轉送至來源。HTTP產生HTTP回應可以減少原點的負載，通常也會減少檢視器的延遲。

產生HTTP回應的一些常見案例包括：

  • 傳回小型網頁給檢視器

  • 返回 HTTP 301 或 302 狀態碼以將用戶重定向到另一個網頁

  • 當用戶未通過身份驗證時，將 HTTP 401 狀態碼返回給查看器

當發生下列 CloudFront 事件時，Lambda @Edge 函數可以產生HTTP回應：

檢視器請求事件

當一個函數由查看器請求事件觸發時， CloudFront 返回響應給查看器，並且不緩存它。

原始伺服器請求事件

當一個函數由來源請求事件觸發時， CloudFront 檢查邊緣緩存是否有先前由該函數生成的響應。

  • 如果響應在緩存中，則不執行該函數，並將緩存響應 CloudFront 返回給查看器。

  • 如果響應不在緩存中，則執行該函數，將響應 CloudFront 返回給查看器，並緩存它。

若要查看產生HTTP回應的範例程式碼，請參閱Lambda@Edge 範例函數。您也可以取代HTTP回應觸發器中的回應。如需詳細資訊，請參閱更新HTTP原始響應觸發器中的響應。

程式設計模型

本節說明使用 Lambda @Edge 產生HTTP回應的程式設計模型。

回應物件

以 result 方法的 callback 參數傳回的回應，需具備下列結構 (請注意，僅 status 欄位為必要)。

const response = {
    body: 'content',
    bodyEncoding: 'text' | 'base64',
    headers: {
        'header name in lowercase': [{
            key: 'header name in standard case',
            value: 'header value'
         }],
         ...
    },
    status: 'HTTP status code (string)',
    statusDescription: 'status description'
};

回應物件可以包含以下值：

body

您想要在產生的回應中傳 CloudFront 回的主體 (如果有的話)。

bodyEncoding

您在 body 中指定的值的編碼。唯一的有效編碼是 text 和 base64。如果您在response物件body中包含但省略bodyEncoding，則 CloudFront 會將內文視為文字。

如果您指定bodyEncoding為，base64但主體不是有效的 base64，則 CloudFront 返回一個錯誤。

headers

您想要在產生的 CloudFront 回應中傳回的標頭。注意下列事項：

  • headers物件中的索引鍵是標準標HTTP頭名稱的小寫版本。使用小寫金鑰提供您區分大小寫的標頭值存取權。

  • 每個標頭 (例如 headers["accept"] 或 headers["host"]) 是一系列的鍵值組。於已知的標頭，陣列在產生的回應中包含每個值的一組鍵值組。

  • key(選擇性) 是標頭出現在HTTP要求中時區分大小寫的名稱；例如，accept或host。

  • 指定 value 為標頭值。

  • 如果您未加入索引鍵/值組的標頭索引鍵部分，Lambda@Edge 會自動使用您提供的標頭名稱，來插入標頭索引鍵。無論您如何安排標頭格式，各部分插入的標頭索引鍵名稱都會自動以大寫開頭，以連字號 (-) 分隔。

    例如，您可以不用標頭索引鍵，新增標頭如下：'content-type': [{ value: 'text/html;charset=UTF-8' }]

    在這個範例中，Lambda@Edge 建立了下列標頭索引鍵：Content-Type。

如需標頭使用限制的詳細資訊，請參閱對邊緣函數的限制。

status

狀HTTP態碼。以字串形式提供狀態碼。 CloudFront 使用提供的狀態碼進行以下操作：

如果該status值不在 200 和 599 之間，則會將錯誤 CloudFront 傳回給檢視器。

statusDescription

您要在響應中 CloudFront 返回的描述，以伴隨狀HTTP態代碼。您不需要使用標準描述，OK例如HTTP狀態碼為 200。

錯誤

以下是產生HTTP回應的可能錯誤。

回應包含本文與指定 204 (無內容) 狀態

當檢視器要求觸發函數時，當下列兩項成立時，會將 HTTP 502 狀態碼 (錯誤閘道) CloudFront 傳回給檢視器：

  • status 的值是 204 (無內容)

  • 回應包含 body 的值

這是因為 Lambda @Edge 會強制執行 RFC 2616 中找到的選擇性限制，其中指出HTTP 204回應不需要包含訊息內文。

已產生回應的大小限制

由 Lambda 函數產生的回應大小上限取決於觸發函數的事件：

  • 檢視器請求事件 – 40 KB

  • 原始伺服器請求事件 – 1 MB

如果回應大於允許的大小，則會將 HTTP 502 狀態碼 (錯誤閘道) CloudFront 傳回給檢視器。

必要欄位

status 欄位是必要的。

所有其他欄位是選用的。

更新HTTP原始響應觸發器中的響應

當 CloudFront 收到來自原始伺服器的回HTTP應時，如果存在與快取行為相關聯的來源回應觸發程序，您可以修改回HTTP應，以覆寫原始伺服器傳回的內容。

更新HTTP回應的一些常見案例包括：

注意

該函數必須返回到200和599（含）之間的狀態值，否則 CloudFront 返回一個錯誤給查看器。

您也可以取代檢視器和來源要求事件中的HTTP回應。如需詳細資訊，請參閱在請求觸發器中產生HTTP回應。

當您使用回HTTP應時，Lambda @Edge 不會將原始伺服器傳回的主體公開給來源回應觸發程序。您可以藉由設定為所需的值來產生靜態內容本文，或藉由設定空值來移除函數內的本文。如果您不更新函數的本文欄位，原始伺服器回傳的原始主體會傳回給檢視器。

選擇包含主體選項以存取要求主體

您可以選擇讓 Lambda @Edge 在可寫入HTTP方法 (POST、等等) 的要求中公開本文 PUTDELETE，以便您可以在 Lambda 函數中存取它。您可以選擇唯讀存取或指定您將替換內文。

若要啟用此選項，請在針對檢視器要求或來源要求事件建立函數的 CloudFront 觸發器時，選擇「包含內文」。如需詳細資訊，請參閱 為 Lambda @Edge 函數新增觸發程序；或者，若要進一步了解使用包含內文與您的函數，請參閱 Lambda@Edge 事件結構說明頁面。

您可能會想使用此功能的情境，包括下列的案例：

  • 處理 Web 表單，例如「聯絡我們」表單，而不將客戶輸入的資料傳回給原始伺服器。

  • 收集由檢視器的瀏覽器所傳送的網站信標資料，並且在邊緣處理這些資料。

如需程式碼範例，請參閱 Lambda@Edge 範例函數。

注意

如果請求主體的資料大小過大，Lambda@Edge 會將主體截斷。如需大小上限和截斷的詳細資訊，請參閱使用包含內文選項時的要求內文限制。