我的 Python(Boto3)AWS Lambda 函數傳回「未知服務」、「參數驗證失敗」或「物件無屬性」錯誤訊息。
簡短說明
未使用最新版本的 Boto3 的 Python (Boto3) Lambda 函數可能會傳回以下錯誤訊息:
當函數呼叫需要最新版本的 Boto3 的 AWS 服務或 AWS API 時,就會發生這些錯誤。
若要解決此問題,請建立使用最新版本的 Boto3 的 Lambda 圖層。您可以手動或使用 Docker 建立 Lambda 圖層。最佳實務是透過 Docker 升級 Lambda 圖層,以確保您的 Lambda 作業系統的二進製數是正確的。
**重要:**以下程序假設您擁有最新版本的 Botocore。如果您沒有最新版本的 Botocore,那麼您必須先升級 Botocore,然後才能升級到最新的 Boto3 版本。如需詳細資訊,請參閱 GitHub 網站上的 botocore。
解決方法
**注意:**如果您在執行 AWS Command Line Interface (AWS CLI) 命令時收到錯誤,則請參閱對 AWS CLI 進行錯誤疑難排解。此外,請確定您使用的是最新的 AWS CLI 版本。
最佳做法是在 Lambda 執行時期所依據的相同作業系統上建立 Lambda 圖層。例如,Python 3.8 和 3.9 版本基於 Amazon Linux 2 Amazon Machine Image(AMI)。但是,Python 3.7 和 Python 3.6 是基於 Amazon Linux AMI。
先決條件:
- 安裝用於 Python 3 套件的 pip3。或者,如果您有舊版的 pip,則進行升級。如需詳細資訊,請參閱 pip 網站上的安裝。
- 使用 pip3 安裝或更新 AWS CLI。
**注意:**最新版本的 AWS CLI 包含 Lambda Layers API 模型。
使用 Docker 建立或更新使用最新 Boto3 版本的 Lambda 層次
**先決條件:**在您的系統上安裝 Docker。若要下載最新版本的 Docker,請參閱 安裝 Docker。
**建立並套用圖層 **
請完成下列步驟:
-
導覽至您要建立圖層檔案的目錄。
-
在系統的 CLI 中執行下列命令:
docker run --entrypoint "" -v "$PWD":/var/task "public.ecr.aws/lambda/python:3.9.2023.03.21.20" /bin/sh -c "mkdir -p /tmp/python && pip3 install boto3 -t /tmp/python && cd /tmp && yum install -y zip && zip -r /var/task/boto3-mylayer.zip ."
注意: 將 public.ecr.aws/lambda/python:3.9.2023.03.21.20 取代為您的 Python 版本的基本映像。使用您的套件之自訂名稱取代 boto3-mylayer。
成功完成命令,您會在目前的目錄中看到有套餐名稱的檔案,例如 ** boto3-mylayer.zip**。
-
若要建立或更新 Lambda 圖層,請執行下列命令:
aws lambda publish-layer-version --layer-name boto3-mylayer --zip-file fileb://boto3-mylayer.zip --compatible-runtimes python3.9 --region REGION_NAME
注意: 將 boto3-mylayer 取代為您的套件名稱。使用**您的 AWS 區域取代 **REGION_NAME。此外,請列入您先前指定的相容執行期。
手動建立使用最新 Boto3 版本的 Lambda 圖層
下列 AWS CLI 命令適用於 Linux、Unix 和 macOS 作業系統。
**注意:**在每個命令中,請確保您有為 lib 資料夾和 Lambda 圖層將 boto3-mylayer 取代為您所偏好的名稱。
請完成下列步驟:
-
建立一個 lib 資料夾:
LIB_DIR=boto3-mylayer/pythonmkdir
-
將程式庫安裝到 LIB_DIR。
pip3 install boto3 -t $LIB_DIR
-
要將所有相依性壓縮到 /tmp/boto3-mylayer.zip,請執行以下命令。
cd boto3-mylayer
zip -r /tmp/boto3-mylayer.zip
-
若要發佈圖層,請執行下列命令。
aws lambda publish-layer-version --layer-name boto3-mylayer --zip-file fileb:///tmp/boto3-mylayer.zip
該命令傳回新圖層的Amazon Resource Name (ARN)。
範例輸出結果:
arn:aws:lambda:region:$ACC_ID:layer:boto3-mylayer:1
將新圖層新增至 Lambda 函數的組態
若要將新層新增至 Lambda 函數的組態,請執行下列命令:
aws lambda update-function-configuration --function-name MY_FUNCTION --layers LAYER_ARN
**注意:**將 MY_FUNCTION 取代為您的函數名稱。將 LAYER_ARN 取代為您圖層的 ARN。
所有 AWS 服務和引數現在均可供 Lambda 函數使用。
要確認 Boto3 和 Botocore 的版本,請使用函數代碼中的 print(boto3.__version__) 和 print(botocore.__version__)。
相關資訊
使用 Python 建置 Lambda 函數
使用 Python Lambda 函數的 .zip 檔案封存