View a markdown version of this page

將層新增至事件函數 - AWS Lambda
尋找圖層資訊

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

將層新增至事件函數

Lambda 層是含有補充程式碼或資料的 .zip 封存檔。層通常具備程式庫相依性、自訂執行期或組態檔案。

本節說明如何將圖層新增至 Lambda 事件函數。若要進一步了解有關層的概念性資訊以及您可能會考慮使用的原因，請參閱 使用 layer 管理 Lambda 事件函數相依性。

設定 Event Function 以使用 layer 之前，您必須：

您最多可以將五個圖層新增至事件函數。Event Function 和所有 layer 的總解壓縮大小不能超過 250 MB 的解壓縮部署套件大小配額。如需詳細資訊，請參閱Lambda 配額。

您的事件函數可以繼續使用您已新增的任何 layer 版本，即使在刪除該 layer 版本之後，或是撤銷您存取 layer 的許可之後。不過，您無法建立使用已刪除 layer 版本的新 Event Function。

將圖層新增至事件函數

  1. 開啟 Lambda 主控台的事件函數頁面。

  2. 選擇事件函數。

  3. 向下捲動至層區段，然後選擇新增層。

  4. 在選擇層下方選擇層來源：

    1. AWS layer：從 AWS受管擴充功能清單中選擇。

    2. 自訂層：選擇在您 AWS 帳戶中建立的層。

    3. 指定 ARN：若要使用來自不同 AWS 帳戶 的 layer，例如第三方延伸模組，請輸入 Amazon Resource Name (ARN)。

  5. 選擇新增。

新增層的順序即 Lambda 將層內容合併至執行環境的順序。您可以使用主控台來變更層合併順序。

更新事件函數的層合併順序 （主控台）

  1. 開啟 Lambda 主控台的事件函數頁面。

  2. 選擇要設定的事件函數。

  3. 在 Layers (層) 下方，選擇 Edit (編輯)

  4. 選擇其中一個層。

  5. 選擇 Merge earlier (先前合併) 或 Merge later (稍後合併) 來調整層的順序。

  6. 選擇儲存。

層已設定版本控制。每個層版本的內容都是不可變的。層擁有者可發行新的層版本，以提供更新內容。您可以使用 主控台來更新連接至 Event Functions 的 layer 版本。

更新 Event Function 的 layer 版本 （主控台）

  1. 開啟 Lambda 主控台中的層頁面。

  2. 選擇您要更新版本的層。

  3. 選擇使用此版本的函數標籤。

  4. 選擇您要修改的事件函數，然後選擇編輯。

  5. 在層版本中選擇要變更的層版本。

  6. 選擇 Update functions (更新函數)。

您無法跨 AWS 帳戶更新 Event Function layer 版本。

尋找圖層資訊

若要尋找您帳戶中與 Event Function 執行時間相容的層，請使用 ListLayers API。例如，您可以使用下列 list-layers AWS Command Line Interface (CLI) 命令：

aws lambda list-layers --compatible-runtime python3.14

您應該會看到類似下列的輸出：

{
    "Layers": [
        {
            "LayerName": "my-layer",
            "LayerArn": "arn:aws:lambda:us-east-2:123456789012:layer:my-layer",
            "LatestMatchingVersion": {
                "LayerVersionArn": "arn:aws:lambda:us-east-2:123456789012:layer:my-layer:2",
                "Version": 2,
                "Description": "My layer",
                "CreatedDate": "2025-04-15T00:37:46.592+0000",
                "CompatibleRuntimes": [
                    "python3.14"
                ]
            }
        }
    ]
}

若要在您的帳戶中列出所有層，請忽略 --compatible-runtime 選項。回應詳細資訊會顯示各個層的最新版本。

您還可使用 ListLayerVersions API 取得層的最新版本。舉例來說，您可以使用下列 list-layer-versions CLI 命令：

aws lambda list-layer-versions --layer-name my-layer

您應該會看到類似下列的輸出：

{
    "LayerVersions": [
        {
            "LayerVersionArn": "arn:aws:lambda:us-east-2:123456789012:layer:my-layer:2",
            "Version": 2,
            "Description": "My layer",
            "CreatedDate": "2023-11-15T00:37:46.592+0000",
            "CompatibleRuntimes": [
                "java11"
            ]
        },
        {
            "LayerVersionArn": "arn:aws:lambda:us-east-2:123456789012:layer:my-layer:1",
            "Version": 1,
            "Description": "My layer",
            "CreatedDate": "2023-11-15T00:27:46.592+0000",
            "CompatibleRuntimes": [
                "java11"
            ]
        }
    ]
}