PublishVersion

從目前的程式碼及函數組態中建立版本。使用版本來建立您沒有變更的函數程式碼及組態快照。

如果函數的組態和程式碼自上一個版本後沒有變更，則 AWS Lambda 不會發布版本。使用 UpdateFunctionCode 或 UpdateFunctionConfiguration 更新函數，然後再發佈版本。

用戶端可以直接調用版本或使用別名調用版本。若要建立別名，請使用 CreateAlias。

請求語法


POST /2015-03-31/functions/FunctionName/versions HTTP/1.1
Content-type: application/json

{
   "CodeSha256": "string",
   "Description": "string",
   "RevisionId": "string"
}

URI 請求參數

請求會使用下列 URI 參數。

FunctionName

Lambda 函數的名稱。

名稱格式

函數名稱 - MyFunction。
函數 ARN - arn:aws:lambda:us-west-2:123456789012:function:MyFunction。
部分 ARN - 123456789012:function:MyFunction。

長度限制條件僅會套用到完整的 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 格式的下列資料。

CodeSha256

只有在雜湊值符合指定的值時，才發佈版本。使用此選項來避免在您最近一次更新它之後，函數程式碼產生變更時發佈版本。您可以從 UpdateFunctionCode 輸出中獲取已上傳版本的雜湊。

類型：字串

必要：否

Description

要複寫函數組態中描述的版本描述。

類型：字串

長度限制：長度下限為 0。長度上限為 256。

必要：否

RevisionId

只有在修訂版本 ID 符合指定的 ID 時才更新函數。如果自從上次更新之後，函數組態發生變更，請使用此選項以避免發佈版本。

類型：字串

必要：否

回應語法


HTTP/1.1 201
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 201 回應。

服務會傳回下列 JSON 格式的資料。

Architectures

函數支援的指令集架構。架構是具有其中一個有效值的字串陣列。預設架構值為 x86_64。

類型：字串陣列

陣列成員：固定項目數為 1。

有效值:x86_64 | arm64

CodeSha256

函數部署套件的 SHA256 雜湊。

類型：字串

CodeSize

函數部署套件的大小 (以位元組為單位)。

類型：Long

DeadLetterConfig

函數的無效字母佇列。

類型：DeadLetterConfig 物件

Description

函數的描述。

類型：字串

長度限制：長度下限為 0。長度上限為 256。

Environment

函數的環境變數。從 AWS CloudTrail 日誌中省略。

類型：EnvironmentResponse 物件

EphemeralStorage

函數的 /tmp 目錄大小，以 MB 為單位。預設值為 512，但可以是介於 512 和 10,240 MB 之間的任何非負整數。如需詳細資訊，請參閱設定暫時性儲存 (主控台)。

類型：EphemeralStorage 物件

FileSystemConfigs

Amazon EFS 檔案系統的連線設定。

類型：FileSystemConfig 物件陣列

陣列成員：最多 1 個項目。

FunctionArn

函數的 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

函數的名稱。

類型：字串

長度限制：長度下限為 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

Lambda 為了開始執行您的函數所呼叫的函數。

類型：字串

長度限制：長度上限為 128。

模式：[^\s]+

ImageConfigResponse

函數的映像組態值。

類型：ImageConfigResponse 物件

KMSKeyArn

用來加密函數環境變數的 AWS KMS key。啟動 Lambda SnapStart 時，也會使用此金鑰來加密函數的快照集。只有在您已設定客戶受管金鑰的情況下，才會傳回此金鑰。

類型：String

模式：(arn:(aws[a-zA-Z-]*)?:[a-z0-9-.]+:.*)|()

LastModified

上次更新函數的日期和時間，採用 ISO-8601 格式 (YYYY-MM-DDThh:mm:ss.sTZD)。

類型：字串

LastUpdateStatus

對函數執行的上次更新的狀態。這是在函數建立完成後首次設定為 Successful。

類型：字串

有效值:Successful | Failed | InProgress

LastUpdateStatusReason

對函數執行的上次更新的原因。

類型：字串

LastUpdateStatusReasonCode

對函數執行的上次更新的原因代碼。

類型：字串

Layers

函數的層。

類型：Layer 物件陣列

LoggingConfig

該功能的 Amazon CloudWatch 日誌配置設置。

類型：LoggingConfig 物件

MasterArn

若是 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

可供函數在執行階段使用的記憶體量。

類型：整數

有效範圍：最小值為 128。最大值為 10240。

PackageType

部署套件的類型。針對容器影像設定為 Image，並針對 .zip 檔案封存設定 Zip。

類型：字串

有效值:Zip | Image

RevisionId

函數或別名的最新更新修訂版。

類型：字串

Role

函數的執行角色。

類型：String

模式：arn:(aws[a-zA-Z-]*)?:iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+

Runtime

函數的執行時間的識別符。如果部署套件是 .zip 檔案封存，則需要執行時間。

下列清單包含已淘汰的執行時間。如需詳細資訊，請參閱執行時間淘汰政策。

類型：字串

RuntimeVersionConfig

執行階段的 ARN 和任何發生的錯誤。

類型：RuntimeVersionConfig 物件

SigningJobArn

簽署任務的 ARN。

類型：String

模式：arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)

SigningProfileVersionArn

簽署描述檔版本的 ARN。

類型：String

模式：arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)

SnapStart

將 ApplyOn 設為 PublishedVersions，即可在您發佈函數版本時建立初始化執行環境的快照。如需詳細資訊，請參閱使用 Lambda 改善啟動效能 SnapStart。

類型：SnapStartResponse 物件

State

函數目前的狀態。當狀態為 Inactive 時，您可以透過調用它來重新激活該函數。

類型：字串

有效值:Pending | Active | Inactive | Failed

StateReason

函數目前狀態的原因。

類型：字串

StateReasonCode

函數目前狀態的原因代碼。當代碼為 Creating 時，則無法調用或修改函數。

類型：字串

Timeout

Lambda 在停止函數前允許函數執行的時間 (以秒為單位)。

類型：整數

有效範圍：最小值為 1。

TracingConfig

函數的 AWS X-Ray 追蹤組態。

類型：TracingConfigResponse 物件

Version

Lambda 函數的版本。

類型：字串

長度限制：長度下限為 1。長度上限為 1024。

模式：(\$LATEST|[0-9]+)

VpcConfig

函數的聯網設定。

類型：VpcConfigResponse 物件

錯誤

如需所有動作常見錯誤的資訊，請參閱常見錯誤。

CodeStorageExceededException

您的 AWS 帳戶已超過總程式碼大小上限。如需詳細資訊，請參閱 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 配額。

HTTP 狀態碼：429

另請參閱

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

PublishLayerVersion

PutFunctionCodeSigningConfig