本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # UpdateFunctionCode 更新 Lambda 函數的程式碼。如果已對函數啟用程式碼簽署，則程式碼套件必須由受信任的發佈者簽署。如需詳細資訊，請參閱[為 Lambda 設定程式碼簽署](https://docs.aws.amazon.com/lambda/latest/dg/configuration-codesigning.html)。如果函數的套件類型是 `Image`，那麼您必須將 `ImageUri` 中的程式碼套件指定為 Amazon ECR 登錄檔中的[容器映像](https://docs.aws.amazon.com/lambda/latest/dg/lambda-images.html)。如果函數套件類型是 `Zip`，那麼您必須將部署套件指定為 [.zip 封存檔](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-package.html#gettingstarted-package-zip)。輸入 Amazon S3 儲存貯體和程式碼 .zip 檔案位置的金鑰。您也可以使用 `ZipFile` 欄位來提供內嵌的函數程式碼。部署套件中的程式碼必須與函數 (`x86-64` 或 `arm64`) 的目標指令集架構相容。當您發佈版本時，函數的程式碼被鎖定。您無法修改已發佈版本的程式碼，只能修改未發佈版本。 **注意** 對於定義為容器映像的函數，Lambda 會將映像標籤解析為映像摘要。在 Amazon ECR 中，如果您將映像標籤更新為新映像，則 Lambda 不會自動更新該函數。 ## 請求語法 ``` PUT /2015-03-31/functions/FunctionName/code HTTP/1.1 Content-type: application/json { "Architectures": [ "string" ], "DryRun": boolean, "ImageUri": "string", "Publish": boolean, "RevisionId": "string", "S3Bucket": "string", "S3Key": "string", "S3ObjectVersion": "string", "ZipFile": blob } ``` ## URI 請求參數請求會使用下列 URI 參數。 ** [FunctionName](#API_UpdateFunctionCode_RequestSyntax) ** Lambda 函數的名稱。 **名稱格式** + **函數名稱** - `my-function`。 + **函數 ARN** - `arn:aws:lambda:us-west-2:123456789012:function:my-function`。 + **部分 ARN** - `123456789012:function:my-function`。長度限制條件僅會套用到完整的 ARN。若您僅指定函數名稱，則其長度限制為 64 個字元。長度限制：長度下限為 1。長度上限為 140。模式：`(arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}(-gov)?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_]+)(:(\$LATEST|[a-zA-Z0-9-_]+))?` 必要：是 ## 請求主體請求接受採用 JSON 格式的下列資料。 ** [Architectures](#API_UpdateFunctionCode_RequestSyntax) ** 函數支援的指令集架構。輸入具有其中一個有效值 (arm64 或 x86\$164) 的字串陣列。預設值為 `x86_64`。類型：字串陣列陣列成員：固定項目數為 1。有效值:`x86_64 | arm64` 必要：否 ** [DryRun](#API_UpdateFunctionCode_RequestSyntax) ** 設定為 true 可驗證請求參數並存取許可，而無需修改函數程式碼。類型：布林值必要：否 ** [ImageUri](#API_UpdateFunctionCode_RequestSyntax) ** Amazon ECR 登錄檔中容器映像的 URI。請勿將此函數用於以 .zip 檔案封存定義的函數。類型：字串必要：否 ** [Publish](#API_UpdateFunctionCode_RequestSyntax) ** 設為 true，以在更新程式碼之後發佈新版本的函數。此操作與單獨呼叫 [PublishVersion](API_PublishVersion.md) 效果相同。類型：布林值必要：否 ** [RevisionId](#API_UpdateFunctionCode_RequestSyntax) ** 只有在修訂版本 ID 符合指定的 ID 時才更新函數。使用此選項來避免修改自您最近一次讀取之後產生變更的函數。類型：字串必要：否 ** [S3Bucket](#API_UpdateFunctionCode_RequestSyntax) ** 與您的函數位於同一 AWS 區域的 Amazon S3 儲存貯體。儲存貯體可位於不同的 AWS 帳戶中。只能與 .zip 檔案封存部署套件定義的函數搭配使用。類型：字串長度限制：長度下限為 3。長度上限為 63。模式：`^[0-9A-Za-z\.\-_]*(? 部署套件的 Amazon S3 金鑰。只能與 .zip 檔案封存部署套件定義的函數搭配使用。類型：字串長度限制：長度下限為 1。長度上限為 1024。必要：否 ** [S3ObjectVersion](#API_UpdateFunctionCode_RequestSyntax) ** 對於版本控制的物件，要使用的部署套件物件版本。類型：字串長度限制：長度下限為 1。長度上限為 1024。必要：否 ** [ZipFile](#API_UpdateFunctionCode_RequestSyntax) ** 部署套件的 base64 編碼內容。AWSSDK 和 AWS CLI 用戶端會為您處理編碼。只能與 .zip 檔案封存部署套件定義的函數搭配使用。類型：Base64 編碼的二進位資料物件必要：否 ## 回應語法 ``` HTTP/1.1 200 Content-type: application/json { "Architectures": [ "string" ], "CodeSha256": "string", "CodeSize": number, "DeadLetterConfig": { "TargetArn": "string" }, "Description": "string", "Environment": { "Error": { "ErrorCode": "string", "Message": "string" }, "Variables": { "string" : "string" } }, "EphemeralStorage": { "Size": number }, "FileSystemConfigs": [ { "Arn": "string", "LocalMountPath": "string" } ], "FunctionArn": "string", "FunctionName": "string", "Handler": "string", "ImageConfigResponse": { "Error": { "ErrorCode": "string", "Message": "string" }, "ImageConfig": { "Command": [ "string" ], "EntryPoint": [ "string" ], "WorkingDirectory": "string" } }, "KMSKeyArn": "string", "LastModified": "string", "LastUpdateStatus": "string", "LastUpdateStatusReason": "string", "LastUpdateStatusReasonCode": "string", "Layers": [ { "Arn": "string", "CodeSize": number, "SigningJobArn": "string", "SigningProfileVersionArn": "string" } ], "LoggingConfig": { "ApplicationLogLevel": "string", "LogFormat": "string", "LogGroup": "string", "SystemLogLevel": "string" }, "MasterArn": "string", "MemorySize": number, "PackageType": "string", "RevisionId": "string", "Role": "string", "Runtime": "string", "RuntimeVersionConfig": { "Error": { "ErrorCode": "string", "Message": "string" }, "RuntimeVersionArn": "string" }, "SigningJobArn": "string", "SigningProfileVersionArn": "string", "SnapStart": { "ApplyOn": "string", "OptimizationStatus": "string" }, "State": "string", "StateReason": "string", "StateReasonCode": "string", "Timeout": number, "TracingConfig": { "Mode": "string" }, "Version": "string", "VpcConfig": { "Ipv6AllowedForDualStack": boolean, "SecurityGroupIds": [ "string" ], "SubnetIds": [ "string" ], "VpcId": "string" } } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [Architectures](#API_UpdateFunctionCode_ResponseSyntax) ** 函數支援的指令集架構。架構是具有其中一個有效值的字串陣列。預設架構值為 `x86_64`。類型：字串陣列陣列成員：固定項目數為 1。有效值:`x86_64 | arm64` ** [CodeSha256](#API_UpdateFunctionCode_ResponseSyntax) ** 函數部署套件的 SHA256 雜湊。類型：字串 ** [CodeSize](#API_UpdateFunctionCode_ResponseSyntax) ** 函數部署套件的大小 (以位元組為單位)。類型：Long ** [DeadLetterConfig](#API_UpdateFunctionCode_ResponseSyntax) ** 函數的無效字母佇列。類型：[DeadLetterConfig](API_DeadLetterConfig.md) 物件 ** [Description](#API_UpdateFunctionCode_ResponseSyntax) ** 函數的描述。類型：字串長度限制：長度下限為 0。長度上限為 256。 ** [Environment](#API_UpdateFunctionCode_ResponseSyntax) ** 函數的[環境變數](https://docs.aws.amazon.com/lambda/latest/dg/configuration-envvars.html)。從 AWS CloudTrail 日誌中省略。類型：[EnvironmentResponse](API_EnvironmentResponse.md) 物件 ** [EphemeralStorage](#API_UpdateFunctionCode_ResponseSyntax) ** 函數的 `/tmp` 目錄大小，以 MB 為單位。預設值為 512，但可以是介於 512 和 10,240 MB 之間的任何非負整數。如需詳細資訊，請參閱[設定暫時性儲存 (主控台)](https://docs.aws.amazon.com/lambda/latest/dg/configuration-function-common.html#configuration-ephemeral-storage)。類型：[EphemeralStorage](API_EphemeralStorage.md) 物件 ** [FileSystemConfigs](#API_UpdateFunctionCode_ResponseSyntax) ** [Amazon EFS 檔案系統](https://docs.aws.amazon.com/lambda/latest/dg/configuration-filesystem.html)的連線設定。類型：[FileSystemConfig](API_FileSystemConfig.md) 物件陣列陣列成員：最多 1 個項目。 ** [FunctionArn](#API_UpdateFunctionCode_ResponseSyntax) ** 函數的 Amazon Resource Name (ARN)。類型：String 模式：`arn:(aws[a-zA-Z-]*)?:lambda:[a-z]{2}(-gov)?-[a-z]+-\d{1}:\d{12}:function:[a-zA-Z0-9-_\.]+(:(\$LATEST|[a-zA-Z0-9-_]+))?` ** [FunctionName](#API_UpdateFunctionCode_ResponseSyntax) ** 函數的名稱。類型：字串長度限制：長度下限為 1。長度上限為 170。模式：`(arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}(-gov)?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_\.]+)(:(\$LATEST|[a-zA-Z0-9-_]+))?` ** [Handler](#API_UpdateFunctionCode_ResponseSyntax) ** Lambda 為了開始執行您的函數所呼叫的函數。類型：字串長度限制：長度上限為 128。模式：`[^\s]+` ** [ImageConfigResponse](#API_UpdateFunctionCode_ResponseSyntax) ** 函數的映像組態值。類型：[ImageConfigResponse](API_ImageConfigResponse.md) 物件 ** [KMSKeyArn](#API_UpdateFunctionCode_ResponseSyntax) ** 用來加密函數[環境變數](https://docs.aws.amazon.com/lambda/latest/dg/configuration-envvars.html#configuration-envvars-encryption)的 AWS KMS key。啟動 [Lambda SnapStart](https://docs.aws.amazon.com/lambda/latest/dg/snapstart-security.html) 時，也會使用此金鑰來加密函數的快照集。只有在您已設定客戶受管金鑰的情況下，才會傳回此金鑰。類型：String 模式：`(arn:(aws[a-zA-Z-]*)?:[a-z0-9-.]+:.*)|()` ** [LastModified](#API_UpdateFunctionCode_ResponseSyntax) ** 上次更新函數的日期和時間，採用 [ISO-8601](https://www.w3.org/TR/NOTE-datetime) 格式 (YYYY-MM-DDThh:mm:ss.sTZD)。類型：字串 ** [LastUpdateStatus](#API_UpdateFunctionCode_ResponseSyntax) ** 對函數執行的上次更新的狀態。這是在函數建立完成後首次設定為 `Successful`。類型：字串有效值:`Successful | Failed | InProgress` ** [LastUpdateStatusReason](#API_UpdateFunctionCode_ResponseSyntax) ** 對函數執行的上次更新的原因。類型：字串 ** [LastUpdateStatusReasonCode](#API_UpdateFunctionCode_ResponseSyntax) ** 對函數執行的上次更新的原因代碼。類型：字串有效值:`EniLimitExceeded | InsufficientRolePermissions | InvalidConfiguration | InternalError | SubnetOutOfIPAddresses | InvalidSubnet | InvalidSecurityGroup | ImageDeleted | ImageAccessDenied | InvalidImage | KMSKeyAccessDenied | KMSKeyNotFound | InvalidStateKMSKey | DisabledKMSKey | EFSIOError | EFSMountConnectivityError | EFSMountFailure | EFSMountTimeout | InvalidRuntime | InvalidZipFileException | FunctionError` ** [Layers](#API_UpdateFunctionCode_ResponseSyntax) ** 函數的[層](https://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html)。類型：[Layer](API_Layer.md) 物件陣列 ** [LoggingConfig](#API_UpdateFunctionCode_ResponseSyntax) ** 該功能的 Amazon CloudWatch 日誌配置設置。類型：[LoggingConfig](API_LoggingConfig.md) 物件 ** [MasterArn](#API_UpdateFunctionCode_ResponseSyntax) ** 若是 Lambda@Edge 函數，則為主函數的 ARN。類型：String 模式：`arn:(aws[a-zA-Z-]*)?:lambda:[a-z]{2}(-gov)?-[a-z]+-\d{1}:\d{12}:function:[a-zA-Z0-9-_]+(:(\$LATEST|[a-zA-Z0-9-_]+))?` ** [MemorySize](#API_UpdateFunctionCode_ResponseSyntax) ** 可供函數在執行階段使用的記憶體量。類型：整數有效範圍：最小值為 128。最大值為 10240。 ** [PackageType](#API_UpdateFunctionCode_ResponseSyntax) ** 部署套件的類型。針對容器影像設定為 `Image`，並針對 .zip 檔案封存設定 `Zip`。類型：字串有效值:`Zip | Image` ** [RevisionId](#API_UpdateFunctionCode_ResponseSyntax) ** 函數或別名的最新更新修訂版。類型：字串 ** [Role](#API_UpdateFunctionCode_ResponseSyntax) ** 函數的執行角色。類型：String 模式：`arn:(aws[a-zA-Z-]*)?:iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+` ** [Runtime](#API_UpdateFunctionCode_ResponseSyntax) ** 函數的[執行時間](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html)的識別符。如果部署套件是 .zip 檔案封存，則需要執行時間。下列清單包含已淘汰的執行時間。如需詳細資訊，請參閱[執行時間淘汰政策](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtime-support-policy)。類型：字串有效值:`nodejs | nodejs4.3 | nodejs6.10 | nodejs8.10 | nodejs10.x | nodejs12.x | nodejs14.x | nodejs16.x | java8 | java8.al2 | java11 | python2.7 | python3.6 | python3.7 | python3.8 | python3.9 | dotnetcore1.0 | dotnetcore2.0 | dotnetcore2.1 | dotnetcore3.1 | dotnet6 | nodejs4.3-edge | go1.x | ruby2.5 | ruby2.7 | provided | provided.al2 | nodejs18.x | python3.10 | java17 | ruby3.2 | python3.11 | nodejs20.x | provided.al2023 | python3.12 | java21` ** [RuntimeVersionConfig](#API_UpdateFunctionCode_ResponseSyntax) ** 執行階段的 ARN 和任何發生的錯誤。類型：[RuntimeVersionConfig](API_RuntimeVersionConfig.md) 物件 ** [SigningJobArn](#API_UpdateFunctionCode_ResponseSyntax) ** 簽署任務的 ARN。類型：String 模式：`arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)` ** [SigningProfileVersionArn](#API_UpdateFunctionCode_ResponseSyntax) ** 簽署描述檔版本的 ARN。類型：String 模式：`arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)` ** [SnapStart](#API_UpdateFunctionCode_ResponseSyntax) ** 將 `ApplyOn` 設為 `PublishedVersions`，即可在您發佈函數版本時建立初始化執行環境的快照。如需詳細資訊，請參閱[使用 Lambda 改善啟動效能 SnapStart](https://docs.aws.amazon.com/lambda/latest/dg/snapstart.html)。類型：[SnapStartResponse](API_SnapStartResponse.md) 物件 ** [State](#API_UpdateFunctionCode_ResponseSyntax) ** 函數目前的狀態。當狀態為 `Inactive` 時，您可以透過調用它來重新激活該函數。類型：字串有效值:`Pending | Active | Inactive | Failed` ** [StateReason](#API_UpdateFunctionCode_ResponseSyntax) ** 函數目前狀態的原因。類型：字串 ** [StateReasonCode](#API_UpdateFunctionCode_ResponseSyntax) ** 函數目前狀態的原因代碼。當代碼為 `Creating` 時，則無法調用或修改函數。類型：字串有效值:`Idle | Creating | Restoring | EniLimitExceeded | InsufficientRolePermissions | InvalidConfiguration | InternalError | SubnetOutOfIPAddresses | InvalidSubnet | InvalidSecurityGroup | ImageDeleted | ImageAccessDenied | InvalidImage | KMSKeyAccessDenied | KMSKeyNotFound | InvalidStateKMSKey | DisabledKMSKey | EFSIOError | EFSMountConnectivityError | EFSMountFailure | EFSMountTimeout | InvalidRuntime | InvalidZipFileException | FunctionError` ** [Timeout](#API_UpdateFunctionCode_ResponseSyntax) ** Lambda 在停止函數前允許函數執行的時間 (以秒為單位)。類型：整數有效範圍：最小值為 1。 ** [TracingConfig](#API_UpdateFunctionCode_ResponseSyntax) ** 函數的 AWS X-Ray 追蹤組態。類型：[TracingConfigResponse](API_TracingConfigResponse.md) 物件 ** [Version](#API_UpdateFunctionCode_ResponseSyntax) ** Lambda 函數的版本。類型：字串長度限制：長度下限為 1。長度上限為 1024。模式：`(\$LATEST|[0-9]+)` ** [VpcConfig](#API_UpdateFunctionCode_ResponseSyntax) ** 函數的聯網設定。類型：[VpcConfigResponse](API_VpcConfigResponse.md) 物件 ## 錯誤如需所有動作常見錯誤的資訊，請參閱[常見錯誤](CommonErrors.md)。 ** CodeSigningConfigNotFoundException ** 指定的程式碼簽署組態不存在。 HTTP 狀態碼：404 ** CodeStorageExceededException ** 您的 AWS 帳戶已超過總程式碼大小上限。如需詳細資訊，請參閱 [Lambda 配額](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html)。 HTTP 狀態碼：400 ** CodeVerificationFailedException ** 程式碼簽章無法進行一個或多個驗證檢查，因為簽章不符或到期，程式碼簽署政策設定為 ENFORCE。Lambda 會阻止部署。 HTTP 狀態碼：400 ** InvalidCodeSignatureException ** 程式碼簽章無法進行完整性檢查。如果完整性檢查失敗，即使程式碼簽署政策設定為 WARN，Lambda 仍會阻止部署。 HTTP 狀態碼：400 ** InvalidParameterValueException ** 請求中的其中一個參數無效。 HTTP 狀態碼：400 ** PreconditionFailedException ** RevisionId 提供的與 Lambda 函數或別名 RevisionId 的最新版本不相符。呼叫`GetFunction`或 `GetAlias` API 作業以擷取資源 RevisionId 的最新資源。 HTTP 狀態碼：412 ** ResourceConflictException ** 資源已存在，或另一個操作正在進行中。 HTTP 狀態碼：409 ** ResourceNotFoundException ** 請求中指定的資源不存在。 HTTP 狀態碼：404 ** ServiceException ** AWS Lambda 服務發生內部錯誤。 HTTP 狀態碼：500 ** TooManyRequestsException ** 超出請求輸送量限制。如需詳細資訊，請參閱 [Lambda 配額](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests)。 HTTP 狀態碼：429 ## 另請參閱如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明： + [AWS 命令列介面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/UpdateFunctionCode) + [適用於 .NET 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/UpdateFunctionCode) + [適用於 C\$1\$1 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/UpdateFunctionCode) + [適用於 Go 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/UpdateFunctionCode) + [適用於 Java 的 AWS 軟體開發套件第 2 版](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/UpdateFunctionCode) + [AWS適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/UpdateFunctionCode) + [適用於 PHP 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/UpdateFunctionCode) + [適用於 Python 的 AWS 開發套件](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/UpdateFunctionCode) + [適用於 Ruby 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/UpdateFunctionCode)