使用 AWS Lambda 函數 - AWS 適用於 VS 程式碼的工具組
先決條件叫用 Lambda 函數刪除 Lambda 函式下載 Lambda 函式部署新 Lambda 函數的更新上傳現有 Lambda 函數的更新將您的 Lambda 函數轉換為 AWS SAM 專案

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

使用 AWS Lambda 函數

AWS Toolkit for Visual Studio Code 可讓您在本機 VS Code 環境中使用 AWS Lambda 函數。透過 AWS Toolkit，您可以建立、編輯、測試、偵錯和部署 Lambda 函數，而無需離開 IDE。如需 AWS Lambda 服務的詳細資訊，請參閱 AWS Lambda開發人員指南。

下列各節說明如何開始使用 中的 Lambda 函數 AWS Toolkit for Visual Studio Code。

注意

如果您已經使用 建立 Lambda 函數 AWS Management Console，則可以從 Toolkit 叫用它們。此外，您可以從 將 Lambda 函數開啟為 VS 程式碼 AWS Lambda console，如需其他資訊，請參閱本使用者指南中的 AWS Lambda console 至 IDE 主題。若要在 VS 程式碼中建立新的 Lambda 函數，請遵循本使用者指南中建立新的無伺服器應用程式 （本機） 主題中概述的步驟。

先決條件

必須符合下列條件，才能在 AWS Toolkit 中使用 AWS Lambda 服務。

  • 已安裝最新版本的 AWS Toolkit for Visual Studio Code ，並使用 AWS 登入資料進行設定。

  • 您的 AWS Identity and Access Management (IAM) 受管許可和政策已設定為使用 AWS Lambda 服務。如需如何設定許可和建立相容 AWS 受管政策的詳細資訊，請參閱《 AWS Lambda 開發人員指南》中的 AWS Identity and Access ManagementAWS Lambda主題的 。

  • 您現有的 AWS Lambda 函數或 熟悉如何建立一個函數。如需如何建立 Lambda 函數的指示，請參閱《 AWS Lambda 開發人員指南》中的建立您的第一個 Lambda 函數主題。

叫用 Lambda 函數

若要從 AWS 您的帳戶叫用 Lambda 函數至 VS 程式碼，請完成下列步驟。

  1. 從 AWS Toolkit for Visual Studio Code中，展開 AWS 瀏覽器。

  2. 從 AWS 瀏覽器展開 Lambda 以檢視您的 Lambda 資源。

  3. 開啟您要叫用之 Lambda 函數的內容選單 （按一下滑鼠右鍵），然後選擇在雲端叫用，或在雲端圖示中選擇叫用，以在 VS 程式碼中開啟遠端叫用組態選單。

  4. 從遠端調用組態功能表中，指定您的承載設定，並新增事件所需的任何其他資訊。

    注意

    當您在 AWS 瀏覽器中選擇在雲端叫用時，第一個叫用程序可能會立即開始執行。輸出會顯示在 VS 程式碼終端機的 OUTPUT 索引標籤中。

  5. 選擇遠端調用按鈕來調用您的函數，輸出會顯示在 VS 程式碼終端機的輸出索引標籤中。

刪除 Lambda 函式

若要刪除 Lambda 函數，請完成下列程序。

警告

請勿使用此程序刪除與 AWS CloudFormation 相關聯的 Lambda 函數。這些函數必須透過您的 AWS CloudFormation 堆疊刪除。

  1. 從 AWS Toolkit for Visual Studio Code中，展開 AWS 瀏覽器。

  2. 從 AWS 瀏覽器展開 Lambda 以檢視您的 Lambda 資源。

  3. 在要刪除的 Lambda 函數上按一下滑鼠右鍵，然後選擇刪除。

  4. 出現提示時，請確認您想要刪除函數。

刪除函數之後，它不會再列在 AWS 瀏覽器中。

下載 Lambda 函式

您可以從遠端 Lambda 函數下載程式碼到 VS 程式碼工作區，以進行編輯和偵錯。

注意

若要下載 Lambda 函數，您必須在具有可存取資料夾的 VS 程式碼工作區中工作，且 AWS Toolkit 僅支援使用 Node.js 和 Python 執行時間搭配 Lambda 函數使用此功能。

  1. 從 AWS Toolkit for Visual Studio Code中，展開 AWS 瀏覽器。

  2. 從 AWS 瀏覽器展開 Lambda 以檢視您的 Lambda 資源。

  3. 在您要下載的 Lambda 函數上按一下滑鼠右鍵，然後選擇下載。

  4. 您的 Lambda 函數會在 VS 程式碼編輯器中開啟，並在下載完成時顯示在 AWS 瀏覽器中。 AWS Toolkit 也會在 VS Code 執行面板中建立啟動組態，可讓您使用 在本機執行和偵錯 Lambda 函數 AWS Serverless Application Model。如需使用 的詳細資訊 AWS SAM，請參閱 從範本執行和偵錯無伺服器應用程式 （本機）。

部署新 Lambda 函數的更新

您可以從本機機器上未指定的暫時位置部署更新至新的 Lambda 函數。

注意

當您的 lambda 檔案有未部署的變更時，您會透過位於 VS 程式碼編輯器和 AWS 瀏覽器中修改檔案旁邊的 M 圖示收到通知。

從 VS 程式碼編輯器部署

  1. 在 VS 程式碼編輯器中從 Lambda 函數開啟檔案，然後變更檔案。

  2. 從 VS Code 主功能表手動儲存或按 option+s(Mac) ctrl+s (Windows)。

  3. VS Code 會自動提示您將變更部署到雲端，選擇部署按鈕以確認部署。

  4. VS Code 會更新您部署的狀態，並在程序完成時通知您。

從 AWS Explorer 部署

  1. 在 VS 程式碼編輯器中從 Lambda 函數開啟檔案，然後變更檔案。

  2. 從 AWS Toolkit 中，展開 AWS 瀏覽器。

  3. 從 AWS 瀏覽器中，使用您要部署變更的 Lambda 函數展開 AWS 區域。

  4. 從 AWS 區域展開 Lambda 並導覽您要部署變更的函數。

  5. 從函數旁的快速選單中，選擇儲存並部署程式碼圖示。

  6. VS Code 會更新您部署的狀態，並在程序完成時通知您。

上傳現有 Lambda 函數的更新

下列程序說明如何上傳對現有 Lambda 函數所做的本機變更。此功能支援使用任何 Lambda 支援的執行時間上傳。

警告

上傳 Lambda 函數之前，請注意下列事項：

  • 以這種方式更新程式碼不會使用 AWS SAM CLI 進行部署或建立 AWS CloudFormation 堆疊

  • AWS Toolkit 不會驗證程式碼。在上傳任何變更至雲端之前，驗證您的程式碼並測試您的函數 (s)。

上傳 Zip 封存檔

  1. 從 AWS Toolkit for Visual Studio Code中，展開 AWS 瀏覽器。

  2. 從 AWS 瀏覽器展開 Lambda 以檢視您的 Lambda 資源。

  3. 在您要上傳變更的 Lambda 函數上按一下滑鼠右鍵，然後選擇上傳 Lambda... 以開啟選取上傳類型功能表。

  4. 選擇 ZIP Archive 以在ZIP Archive本機目錄中尋找 。

  5. 出現提示時，請確認上傳以開始上傳選取的 ZIP Archive。

  6. 您的上傳狀態會顯示在 VS 程式碼中，上傳程序完成時會通知您。

上傳目錄而不建置

  1. 從 AWS Toolkit for Visual Studio Code中，展開 AWS 瀏覽器。

  2. 從 AWS 瀏覽器展開 Lambda 以檢視您的 Lambda 資源。

  3. 在您要上傳變更的 Lambda 函數上按一下滑鼠右鍵，然後選擇上傳 Lambda... 以開啟選取上傳類型功能表。

  4. 選擇目錄以繼續到建置目錄畫面。

  5. 從建置目錄畫面中，選擇否以選擇要上傳的本機目錄。

  6. 出現提示時，請確認上傳以上傳選取的目錄。

  7. 您的上傳狀態會顯示在 VS 程式碼中，上傳程序完成時會通知您。

使用組建上傳目錄
注意

請注意以下事項：

  • 此程序需要 AWS Serverless Application Model CLI。

  • AWS 工具組會在上傳前通知您無法偵測到相符的處理常式。

  • 若要變更連接至 Lambda 函數的處理常式，請使用 AWS Lambda console 或 AWS Command Line Interface。

  1. 從 AWS Toolkit for Visual Studio Code中，展開 AWS 瀏覽器。

  2. 從 AWS 瀏覽器展開 Lambda 以檢視您的 Lambda 資源。

  3. 在您要上傳變更的 Lambda 函數上按一下滑鼠右鍵，然後選擇上傳 Lambda... 以開啟選取上傳類型功能表。

  4. 選擇目錄以繼續到建置目錄畫面。

  5. 從建置目錄畫面中，選擇是，然後選擇要上傳的本機目錄。

  6. 出現提示時，確認上傳以開始建置和上傳選取的目錄。

  7. 您的上傳狀態會顯示在 VS 程式碼中，上傳程序完成時會通知您。

將您的 Lambda 函數轉換為 AWS SAM 專案

若要將您的 Lambda 函數轉換為 AWS SAM 堆疊，請完成下列步驟。

警告

目前，將 Lambda 函數轉換為 AWS SAM 專案時，僅支援一部分的資源。若要在轉換後尋找任何遺失的資源，請檢查 Lambda 主控台，並手動將其新增至您的 AWS SAM 範本。如需支援和不支援資源的其他詳細資訊，請參閱《 AWS CloudFormation 開發人員指南》中的資源類型支援主題。

  1. 從 AWS Toolkit 中，展開 AWS 瀏覽器。

  2. 從 AWS 瀏覽器中，使用您要轉換為 AWS SAM 專案的 Lambda 函數展開 AWS 區域。

  3. 從 AWS 區域中，展開 Lambda 並導覽您要轉換為 AWS SAM 堆疊的函數。

  4. 從 Lambda 函數旁的快速選單中，選擇轉換為 SAM 應用程式圖示來瀏覽本機檔案系統，並指定新 AWS SAM 專案的位置。

  5. 指定位置後， AWS Toolkit 會開始將您的 Lambda 函數轉換為 AWS SAM 專案，VS Code 會提供程序狀態的更新。

    注意

    此程序可能需要幾分鐘的時間。

  6. 當 VS 程式碼提示時，輸入堆疊名稱，然後按 Enter 鍵繼續。

  7. VS Code 會繼續更新您專案的狀態，然後在程序完成時通知您，並以 VS Code 工作區的形式開啟您的新 AWS SAM 專案。