

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

# CreateFunction
<a name="API_CreateFunction"></a>

建立 Lambda 函數。若要建立函數，您需要[部署套件](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-package.html)和[執行角色](https://docs.aws.amazon.com/lambda/latest/dg/intro-permission-model.html#lambda-intro-execution-role)。部署套件是包含函數程式碼的 .zip 檔案封存或容器映像。執行角色授予函數使用權限AWS 服務，例如用於 CloudWatch 日誌串流和請求追蹤AWS X-Ray的 Amazon Logs。

如果部署套件是[容器映像](https://docs.aws.amazon.com/lambda/latest/dg/lambda-images.html)，您可以將套件類型設定為 `Image`。對於容器映像，程式碼屬性必須在 Amazon ECR 登錄中包含容器映像的 URI。您不需要指定處理常式和執行時間屬性。

如果部署套件是 [.zip 封存檔](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-package.html#gettingstarted-package-zip)，您可以將套件類型設定為 `Zip`。對於 .zip 檔案封存，程式碼屬性會指定 .zip 檔案的位置。您還必須指定處理常式和執行時間屬性。部署套件中的程式碼必須與函數 (`x86-64` 或 `arm64`) 的目標指令集架構相容。如果沒有指定架構，則預設值為 `x86-64`。

當您建立函數時，Lambda 會佈建函數執行個體及其支援的資源。如果您的函數連線到 VPC，則此過程可能需要一分鐘左右。在此期間，您無法調用或修改函數。來自 [GetFunctionConfiguration](API_GetFunctionConfiguration.md) 的回應中的 `State`、`StateReason` 和 `StateReasonCode` 欄位指示函數何時準備調用。如需詳細資訊，請參閱 [Lambda 函數狀態](https://docs.aws.amazon.com/lambda/latest/dg/functions-states.html)。

函數具有未發佈的版本，並且可以具有已發佈的版本和別名。當您更新函數的程式碼和組態時，未發佈的版本會變更。已發佈的版本是無法變更之函數程式碼和組態的快照。別名是映射至版本的具名資源，可變更以映射至不同版本。使用 `Publish` 參數，從其初始組態中建立函數的版本 `1`。

使用其他參數可設定特定版本和函數級設定。稍後使用 [UpdateFunctionConfiguration](API_UpdateFunctionConfiguration.md) 修改版本特定的設定。函數級設定會同時套用至函數的未發佈版本和已發佈版本，並包含標籤 ([TagResource](API_TagResource.md)) 和每個函數的並行限制 ([PutFunctionConcurrency](API_PutFunctionConcurrency.md))。

如果您的部署套件是 .zip 檔案封存，則可以使用程式碼簽署。若要啟用此函數的程式碼簽章，請指定程式碼簽署組態的 ARN。當使用者以 [UpdateFunctionCode](API_UpdateFunctionCode.md) 嘗試部署程式碼套件時，Lambda 會檢查程式碼套件是否具有來自受信任發佈者的有效簽署。程式碼簽署組態包含一組簽署描述檔，定義了此函數的受信任發佈者。

如果另一個 AWS 帳戶 或 AWS 服務 調用您的函數，請使用 [AddPermission](API_AddPermission.md) 建立資源型 AWS Identity and Access Management IAM 政策來授予許可。您可以在版本或別名的函數層級授予許可。

若要直接調用函數，請使用 [Invoke](API_Invoke.md)。若要調用函數以回應其他 AWS 服務 中的事件，請建立事件來源映射 ([CreateEventSourceMapping](API_CreateEventSourceMapping.md))，或在其他服務中設定函數觸發條件。如需詳細資訊，請參閱[調用 Lambda 函數](https://docs.aws.amazon.com/lambda/latest/dg/lambda-invocation.html)。

## 請求語法
<a name="API_CreateFunction_RequestSyntax"></a>

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

{
   "Architectures": [ "string" ],
   "Code": { 
      "ImageUri": "string",
      "S3Bucket": "string",
      "S3Key": "string",
      "S3ObjectVersion": "string",
      "ZipFile": blob
   },
   "CodeSigningConfigArn": "string",
   "DeadLetterConfig": { 
      "TargetArn": "string"
   },
   "Description": "string",
   "Environment": { 
      "Variables": { 
         "string" : "string" 
      }
   },
   "EphemeralStorage": { 
      "Size": number
   },
   "FileSystemConfigs": [ 
      { 
         "Arn": "string",
         "LocalMountPath": "string"
      }
   ],
   "FunctionName": "string",
   "Handler": "string",
   "ImageConfig": { 
      "Command": [ "string" ],
      "EntryPoint": [ "string" ],
      "WorkingDirectory": "string"
   },
   "KMSKeyArn": "string",
   "Layers": [ "string" ],
   "LoggingConfig": { 
      "ApplicationLogLevel": "string",
      "LogFormat": "string",
      "LogGroup": "string",
      "SystemLogLevel": "string"
   },
   "MemorySize": number,
   "PackageType": "string",
   "Publish": boolean,
   "Role": "string",
   "Runtime": "string",
   "SnapStart": { 
      "ApplyOn": "string"
   },
   "Tags": { 
      "string" : "string" 
   },
   "Timeout": number,
   "TracingConfig": { 
      "Mode": "string"
   },
   "VpcConfig": { 
      "Ipv6AllowedForDualStack": boolean,
      "SecurityGroupIds": [ "string" ],
      "SubnetIds": [ "string" ]
   }
}
```

## URI 請求參數
<a name="API_CreateFunction_RequestParameters"></a>

請求不會使用任何 URI 參數。

## 請求主體
<a name="API_CreateFunction_RequestBody"></a>

請求接受採用 JSON 格式的下列資料。

 ** [Architectures](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-Architectures"></a>
函數支援的指令集架構。輸入具有其中一個有效值 (arm64 或 x86\$164) 的字串陣列。預設值為 `x86_64`。  
類型：字串陣列  
陣列成員：固定項目數為 1。  
有效值:`x86_64 | arm64`   
必要：否

 ** [Code](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-Code"></a>
函數的程式碼。  
類型：[FunctionCode](API_FunctionCode.md) 物件  
必要：是

 ** [CodeSigningConfigArn](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-CodeSigningConfigArn"></a>
若要啟用此函數的程式碼簽章，請指定程式碼簽署組態的 ARN。程式碼簽署組態包含一組簽署描述檔，可定義此函數的受信任發佈者。  
類型：字串  
長度限制：長度上限為 200。  
模式：`arn:(aws[a-zA-Z-]*)?:lambda:[a-z]{2}((-gov)|(-iso(b?)))?-[a-z]+-\d{1}:\d{12}:code-signing-config:csc-[a-z0-9]{17}`  
必要：否

 ** [DeadLetterConfig](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-DeadLetterConfig"></a>
無效字母佇列組態，可指定在處理失敗時，Lambda 傳送的非同步事件的佇列或主題。如需詳細資訊，請參閱[無效字母佇列](https://docs.aws.amazon.com/lambda/latest/dg/invocation-async.html#invocation-dlq)。  
類型：[DeadLetterConfig](API_DeadLetterConfig.md) 物件  
必要：否

 ** [Description](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-Description"></a>
函數的敘述。  
類型：字串  
長度限制：長度下限為 0。長度上限為 256。  
必要：否

 ** [Environment](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-Environment"></a>
環境變數，可在執行期間透過函數程式碼取得。  
類型：[Environment](API_Environment.md) 物件  
必要：否

 ** [EphemeralStorage](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-EphemeralStorage"></a>
函數的 `/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_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-FileSystemConfigs"></a>
Amazon EFS 檔案系統的連線設定。  
類型：[FileSystemConfig](API_FileSystemConfig.md) 物件陣列  
陣列成員：最多 1 個項目。  
必要：否

 ** [FunctionName](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-FunctionName"></a>
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-_]+))?`  
必要：是

 ** [Handler](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-Handler"></a>
程式碼中的方法名稱，Lambda 會呼叫此程式碼來執行您的函數。如果部署套件是 .zip 檔案封存，則需要處理常式。格式包含檔案名稱。它也可以包含命名空間和其他限定詞，取決於執行時間。如需詳細資訊，請參閱 [Lambda 程式設計模型](https://docs.aws.amazon.com/lambda/latest/dg/foundation-progmodel.html)。  
類型：字串  
長度限制：長度上限為 128。  
模式：`[^\s]+`  
必要：否

 ** [ImageConfig](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-ImageConfig"></a>
容器映像[組態值](https://docs.aws.amazon.com/lambda/latest/dg/configuration-images.html#configuration-images-settings)，它們會覆寫容器映像 Dockerfile 中的值。  
類型：[ImageConfig](API_ImageConfig.md) 物件  
必要：否

 ** [KMSKeyArn](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-KMSKeyArn"></a>
AWS Key Management Service (AWS KMS) 客戶受管金鑰的 ARN，用於加密函數的[環境變數](https://docs.aws.amazon.com/lambda/latest/dg/configuration-envvars.html#configuration-envvars-encryption)。啟動 [Lambda SnapStart](https://docs.aws.amazon.com/lambda/latest/dg/snapstart-security.html) 時，Lambda 也會使用此金鑰來加密函數的快照集。如果您使用容器映像部署函數，Lambda 也會在部署函數時使用此金鑰來加密函數。請注意，這與在 Amazon Elastic Container Registry (Amazon ECR) 中用於保護容器映像的金鑰不同。若沒有提供客戶受管金鑰，Lambda 會使用預設服務金鑰。  
類型：String  
模式：`(arn:(aws[a-zA-Z-]*)?:[a-z0-9-.]+:.*)|()`  
必要：否

 ** [Layers](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-Layers"></a>
要新增到函數執行環境的[函數 Layer](https://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html)。依 ARN 指定每個 layer (包括版本)。  
類型：字串陣列  
長度限制：長度下限為 1。長度上限為 140。  
模式：`arn:[a-zA-Z0-9-]+:lambda:[a-zA-Z0-9-]+:\d{12}:layer:[a-zA-Z0-9-_]+:[0-9]+`  
必要：否

 ** [LoggingConfig](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-LoggingConfig"></a>
該功能的 Amazon CloudWatch 日誌配置設置。  
類型：[LoggingConfig](API_LoggingConfig.md) 物件  
必要：否

 ** [MemorySize](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-MemorySize"></a>
[可供函數在執行階段使用的記憶體量](https://docs.aws.amazon.com/lambda/latest/dg/configuration-function-common.html#configuration-memory-console)。增加函數記憶體也會增加它的 CPU 配置。預設值為 128 MB。該值可以是 1 MB 的任何倍數。  
類型：整數  
有效範圍：最小值為 128。最大值為 10240。  
必要：否

 ** [PackageType](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-PackageType"></a>
部署套件的類型。為容器映像設定為 `Image`，並為 .zip 封存檔設為 `Zip`。  
類型：字串  
有效值:`Zip | Image`   
必要：否

 ** [Publish](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-Publish"></a>
設為 true，以在建立期間發佈函數的第一個版本。  
類型：布林值  
必要：否

 ** [Role](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-Role"></a>
函數執行角色的 Amazon Resource Name (ARN)。  
類型：String  
模式：`arn:(aws[a-zA-Z-]*)?:iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+`  
必要：是

 ** [Runtime](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-Runtime"></a>
函數的[執行時間](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`   
必要：否

 ** [SnapStart](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-SnapStart"></a>
功能的[SnapStart](https://docs.aws.amazon.com/lambda/latest/dg/snapstart.html)設定。  
類型：[SnapStart](API_SnapStart.md) 物件  
必要：否

 ** [Tags](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-Tags"></a>
要套用到函數的[標籤](https://docs.aws.amazon.com/lambda/latest/dg/tagging.html)清單。  
類型：字串到字串映射  
必要：否

 ** [Timeout](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-Timeout"></a>
Lambda 在停止函數前允許函數執行的時間 (以秒為單位)。預設為 3 秒。允許的最大值為 900 秒。如需詳細資訊，請參閱 [Lambda 執行環境](https://docs.aws.amazon.com/lambda/latest/dg/runtimes-context.html)。  
類型：整數  
有效範圍：最小值為 1。  
必要：否

 ** [TracingConfig](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-TracingConfig"></a>
將 `Mode` 設為 `Active`，使用 [X-Ray](https://docs.aws.amazon.com/lambda/latest/dg/services-xray.html) 取樣及追蹤一部分的傳入請求。  
類型：[TracingConfig](API_TracingConfig.md) 物件  
必要：否

 ** [VpcConfig](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-VpcConfig"></a>
對於 VPC 中 AWS 資源的網路連線，指定 VPC 中安全群組和子網路的清單。將函數連接到 VPC 時，只能透過該 VPC 存取資源和網際網路。如需詳細資訊，請參閱[設定 Lambda 函數以存取 VPC 中的資源](https://docs.aws.amazon.com/lambda/latest/dg/configuration-vpc.html)。  
類型：[VpcConfig](API_VpcConfig.md) 物件  
必要：否

## 回應語法
<a name="API_CreateFunction_ResponseSyntax"></a>

```
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"
   }
}
```

## 回應元素
<a name="API_CreateFunction_ResponseElements"></a>

如果動作成功，則服務傳回 HTTP 201 回應。

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

 ** [Architectures](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-Architectures"></a>
函數支援的指令集架構。架構是具有其中一個有效值的字串陣列。預設架構值為 `x86_64`。  
類型：字串陣列  
陣列成員：固定項目數為 1。  
有效值:`x86_64 | arm64` 

 ** [CodeSha256](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-CodeSha256"></a>
函數部署套件的 SHA256 雜湊。  
類型：字串

 ** [CodeSize](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-CodeSize"></a>
函數部署套件的大小 (以位元組為單位)。  
類型：Long

 ** [DeadLetterConfig](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-DeadLetterConfig"></a>
函數的無效字母佇列。  
類型：[DeadLetterConfig](API_DeadLetterConfig.md) 物件

 ** [Description](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-Description"></a>
函數的描述。  
類型：字串  
長度限制：長度下限為 0。長度上限為 256。

 ** [Environment](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-Environment"></a>
函數的[環境變數](https://docs.aws.amazon.com/lambda/latest/dg/configuration-envvars.html)。從 AWS CloudTrail 日誌中省略。  
類型：[EnvironmentResponse](API_EnvironmentResponse.md) 物件

 ** [EphemeralStorage](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-EphemeralStorage"></a>
函數的 `/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_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-FileSystemConfigs"></a>
[Amazon EFS 檔案系統](https://docs.aws.amazon.com/lambda/latest/dg/configuration-filesystem.html)的連線設定。  
類型：[FileSystemConfig](API_FileSystemConfig.md) 物件陣列  
陣列成員：最多 1 個項目。

 ** [FunctionArn](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-FunctionArn"></a>
函數的 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_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-FunctionName"></a>
函數的名稱。  
類型：字串  
長度限制：長度下限為 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_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-Handler"></a>
Lambda 為了開始執行您的函數所呼叫的函數。  
類型：字串  
長度限制：長度上限為 128。  
模式：`[^\s]+`

 ** [ImageConfigResponse](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-ImageConfigResponse"></a>
函數的映像組態值。  
類型：[ImageConfigResponse](API_ImageConfigResponse.md) 物件

 ** [KMSKeyArn](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-KMSKeyArn"></a>
用來加密函數[環境變數](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_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-LastModified"></a>
上次更新函數的日期和時間，採用 [ISO-8601](https://www.w3.org/TR/NOTE-datetime) 格式 (YYYY-MM-DDThh:mm:ss.sTZD)。  
類型：字串

 ** [LastUpdateStatus](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-LastUpdateStatus"></a>
對函數執行的上次更新的狀態。這是在函數建立完成後首次設定為 `Successful`。  
類型：字串  
有效值:`Successful | Failed | InProgress` 

 ** [LastUpdateStatusReason](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-LastUpdateStatusReason"></a>
對函數執行的上次更新的原因。  
類型：字串

 ** [LastUpdateStatusReasonCode](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-LastUpdateStatusReasonCode"></a>
對函數執行的上次更新的原因代碼。  
類型：字串  
有效值:`EniLimitExceeded | InsufficientRolePermissions | InvalidConfiguration | InternalError | SubnetOutOfIPAddresses | InvalidSubnet | InvalidSecurityGroup | ImageDeleted | ImageAccessDenied | InvalidImage | KMSKeyAccessDenied | KMSKeyNotFound | InvalidStateKMSKey | DisabledKMSKey | EFSIOError | EFSMountConnectivityError | EFSMountFailure | EFSMountTimeout | InvalidRuntime | InvalidZipFileException | FunctionError` 

 ** [Layers](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-Layers"></a>
函數的[層](https://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html)。  
類型：[Layer](API_Layer.md) 物件陣列

 ** [LoggingConfig](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-LoggingConfig"></a>
該功能的 Amazon CloudWatch 日誌配置設置。  
類型：[LoggingConfig](API_LoggingConfig.md) 物件

 ** [MasterArn](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-MasterArn"></a>
若是 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_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-MemorySize"></a>
可供函數在執行階段使用的記憶體量。  
類型：整數  
有效範圍：最小值為 128。最大值為 10240。

 ** [PackageType](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-PackageType"></a>
部署套件的類型。針對容器影像設定為 `Image`，並針對 .zip 檔案封存設定 `Zip`。  
類型：字串  
有效值:`Zip | Image` 

 ** [RevisionId](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-RevisionId"></a>
函數或別名的最新更新修訂版。  
類型：字串

 ** [Role](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-Role"></a>
函數的執行角色。  
類型：String  
模式：`arn:(aws[a-zA-Z-]*)?:iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+`

 ** [Runtime](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-Runtime"></a>
函數的[執行時間](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_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-RuntimeVersionConfig"></a>
執行階段的 ARN 和任何發生的錯誤。  
類型：[RuntimeVersionConfig](API_RuntimeVersionConfig.md) 物件

 ** [SigningJobArn](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-SigningJobArn"></a>
簽署任務的 ARN。  
類型：String  
模式：`arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)`

 ** [SigningProfileVersionArn](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-SigningProfileVersionArn"></a>
簽署描述檔版本的 ARN。  
類型：String  
模式：`arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)`

 ** [SnapStart](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-SnapStart"></a>
將 `ApplyOn` 設為 `PublishedVersions`，即可在您發佈函數版本時建立初始化執行環境的快照。如需詳細資訊，請參閱[使用 Lambda 改善啟動效能 SnapStart](https://docs.aws.amazon.com/lambda/latest/dg/snapstart.html)。  
類型：[SnapStartResponse](API_SnapStartResponse.md) 物件

 ** [State](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-State"></a>
函數目前的狀態。當狀態為 `Inactive` 時，您可以透過調用它來重新激活該函數。  
類型：字串  
有效值:`Pending | Active | Inactive | Failed` 

 ** [StateReason](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-StateReason"></a>
函數目前狀態的原因。  
類型：字串

 ** [StateReasonCode](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-StateReasonCode"></a>
函數目前狀態的原因代碼。當代碼為 `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_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-Timeout"></a>
Lambda 在停止函數前允許函數執行的時間 (以秒為單位)。  
類型：整數  
有效範圍：最小值為 1。

 ** [TracingConfig](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-TracingConfig"></a>
函數的 AWS X-Ray 追蹤組態。  
類型：[TracingConfigResponse](API_TracingConfigResponse.md) 物件

 ** [Version](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-Version"></a>
Lambda 函數的版本。  
類型：字串  
長度限制：長度下限為 1。長度上限為 1024。  
模式：`(\$LATEST|[0-9]+)`

 ** [VpcConfig](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-VpcConfig"></a>
函數的聯網設定。  
類型：[VpcConfigResponse](API_VpcConfigResponse.md) 物件

## 錯誤
<a name="API_CreateFunction_Errors"></a>

如需所有動作常見錯誤的資訊，請參閱[常見錯誤](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

 ** 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

## 另請參閱
<a name="API_CreateFunction_SeeAlso"></a>

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
+  [AWS 命令列介面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/CreateFunction) 
+  [適用於 .NET 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/CreateFunction) 
+  [適用於 C\$1\$1 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/CreateFunction) 
+  [適用於 Go 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/CreateFunction) 
+  [適用於 Java 的 AWS 軟體開發套件第 2 版](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/CreateFunction) 
+  [AWS適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/CreateFunction) 
+  [適用於 PHP 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/CreateFunction) 
+  [適用於 Python 的 AWS 開發套件](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/CreateFunction) 
+  [適用於 Ruby 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/CreateFunction) 