

# FunctionConfiguration
<a name="API_FunctionConfiguration"></a>

有关函数配置的详细信息。

## 内容
<a name="API_FunctionConfiguration_Contents"></a>

 ** Architectures **   <a name="lambda-Type-FunctionConfiguration-Architectures"></a>
该函数支持的指令集架构。架构是具有有效值之一的字符串数组。默认架构值是 `x86_64`。  
类型：字符串数组  
数组成员：固定数量为 1 项。  
有效值：`x86_64 | arm64`  
必需：否

 ** CodeSha256 **   <a name="lambda-Type-FunctionConfiguration-CodeSha256"></a>
函数部署包的 SHA256 哈希。  
类型：字符串  
必需：否

 ** CodeSize **   <a name="lambda-Type-FunctionConfiguration-CodeSize"></a>
函数部署包的大小（以字节为单位）。  
类型：长整型  
必需：否

 ** DeadLetterConfig **   <a name="lambda-Type-FunctionConfiguration-DeadLetterConfig"></a>
函数的死信队列。  
类型：[DeadLetterConfig](API_DeadLetterConfig.md) 对象  
必需：否

 ** Description **   <a name="lambda-Type-FunctionConfiguration-Description"></a>
函数说明。  
类型：字符串  
长度约束：最小长度为 0。长度上限为 256。  
必需：否

 ** Environment **   <a name="lambda-Type-FunctionConfiguration-Environment"></a>
函数[环境变量](https://docs.aws.amazon.com/lambda/latest/dg/configuration-envvars.html)。在 AWS CloudTrail 日志中被忽略。  
类型：[EnvironmentResponse](API_EnvironmentResponse.md) 对象  
必需：否

 ** EphemeralStorage **   <a name="lambda-Type-FunctionConfiguration-EphemeralStorage"></a>
函数的 `/tmp` 目录大小（以 MB 为单位）。默认值为 512，但可以是介于 512 到 10240 MB 之间的任意整数。有关更多信息，请参阅[配置短暂存储（控制台）](https://docs.aws.amazon.com/lambda/latest/dg/configuration-function-common.html#configuration-ephemeral-storage)。  
类型：[EphemeralStorage](API_EphemeralStorage.md) 对象  
必需：否

 ** FileSystemConfigs **   <a name="lambda-Type-FunctionConfiguration-FileSystemConfigs"></a>
[Amazon EFS 文件系统](https://docs.aws.amazon.com/lambda/latest/dg/configuration-filesystem.html)的连接设置。  
类型：[FileSystemConfig](API_FileSystemConfig.md) 对象数组  
数组成员：最多 1 个物品。  
必需：否

 ** FunctionArn **   <a name="lambda-Type-FunctionConfiguration-FunctionArn"></a>
函数的 Amazon Resource Name (ARN)。  
类型：字符串  
模式：`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 **   <a name="lambda-Type-FunctionConfiguration-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 **   <a name="lambda-Type-FunctionConfiguration-Handler"></a>
Lambda 为开始运行您的函数而调用的函数。  
类型：字符串  
长度限制：最大长度为 128。  
模式：`[^\s]+`  
必需：否

 ** ImageConfigResponse **   <a name="lambda-Type-FunctionConfiguration-ImageConfigResponse"></a>
函数的镜像配置值。  
类型：[ImageConfigResponse](API_ImageConfigResponse.md) 对象  
必需：否

 ** KMSKeyArn **   <a name="lambda-Type-FunctionConfiguration-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) 时，此密钥还用于加密您的函数的快照。仅当您配置了客户托管密钥时，才会返回此密钥。  
类型：字符串  
模式：`(arn:(aws[a-zA-Z-]*)?:[a-z0-9-.]+:.*)|()`  
必需：否

 ** LastModified **   <a name="lambda-Type-FunctionConfiguration-LastModified"></a>
该函数上次更新的日期和时间，采用 [ISO-8601 格式](https://www.w3.org/TR/NOTE-datetime) (YYYY-MM-DDThh:mm:ss.sTZD)。  
类型：字符串  
必需：否

 ** LastUpdateStatus **   <a name="lambda-Type-FunctionConfiguration-LastUpdateStatus"></a>
上次对函数执行的更新的状态。函数创建完成后，首先设置为 `Successful`。  
类型：字符串  
有效值：`Successful | Failed | InProgress`  
必需：否

 ** LastUpdateStatusReason **   <a name="lambda-Type-FunctionConfiguration-LastUpdateStatusReason"></a>
上次对函数执行更新的原因。  
类型：字符串  
必需：否

 ** LastUpdateStatusReasonCode **   <a name="lambda-Type-FunctionConfiguration-LastUpdateStatusReasonCode"></a>
函数上次更新的原因代码。  
类型：字符串  
有效值：`EniLimitExceeded | InsufficientRolePermissions | InvalidConfiguration | InternalError | SubnetOutOfIPAddresses | InvalidSubnet | InvalidSecurityGroup | ImageDeleted | ImageAccessDenied | InvalidImage | KMSKeyAccessDenied | KMSKeyNotFound | InvalidStateKMSKey | DisabledKMSKey | EFSIOError | EFSMountConnectivityError | EFSMountFailure | EFSMountTimeout | InvalidRuntime | InvalidZipFileException | FunctionError`  
必需：否

 ** Layers **   <a name="lambda-Type-FunctionConfiguration-Layers"></a>
函数的[层](https://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html)。  
类型：[Layer](API_Layer.md) 对象数组  
必需：否

 ** LoggingConfig **   <a name="lambda-Type-FunctionConfiguration-LoggingConfig"></a>
该函数的 Amazon CloudWatch Logs 配置设置。  
类型：[LoggingConfig](API_LoggingConfig.md) 对象  
必需：否

 ** MasterArn **   <a name="lambda-Type-FunctionConfiguration-MasterArn"></a>
对于 Lambda@Edge 函数，为主函数的 ARN。  
类型：字符串  
模式：`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 **   <a name="lambda-Type-FunctionConfiguration-MemorySize"></a>
在运行时 可用于函数的内存 量。  
类型：整数  
有效范围：最小值为 128。最大值为 10240。  
必需：否

 ** PackageType **   <a name="lambda-Type-FunctionConfiguration-PackageType"></a>
部署程序包的类型。将容器映像设置为 `Image`，然后将 .zip 文件存档设置为 `Zip`。  
类型：字符串  
有效值：`Zip | Image`  
必需：否

 ** RevisionId **   <a name="lambda-Type-FunctionConfiguration-RevisionId"></a>
函数或别名的最新更新版本。  
类型：字符串  
必需：否

 ** Role **   <a name="lambda-Type-FunctionConfiguration-Role"></a>
函数的执行角色。  
类型：字符串  
模式：`arn:(aws[a-zA-Z-]*)?:iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+`  
必需：否

 ** Runtime **   <a name="lambda-Type-FunctionConfiguration-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 **   <a name="lambda-Type-FunctionConfiguration-RuntimeVersionConfig"></a>
运行时的 ARN和发生的任何错误。  
类型：[RuntimeVersionConfig](API_RuntimeVersionConfig.md) 对象  
必需：否

 ** SigningJobArn **   <a name="lambda-Type-FunctionConfiguration-SigningJobArn"></a>
签名任务的 ARN。  
类型：字符串  
模式：`arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)`  
必需：否

 ** SigningProfileVersionArn **   <a name="lambda-Type-FunctionConfiguration-SigningProfileVersionArn"></a>
签名配置文件版本的 ARN。  
类型：字符串  
模式：`arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)`  
必需：否

 ** SnapStart **   <a name="lambda-Type-FunctionConfiguration-SnapStart"></a>
发布函数版本时，将 `ApplyOn` 设置为 `PublishedVersions` 以创建初始化执行环境的快照。有关更多信息，请参阅 [Improving startup performance with Lambda SnapStart](https://docs.aws.amazon.com/lambda/latest/dg/snapstart.html)（使用 Lambda SnapStart 提高启动性能）。  
类型：[SnapStartResponse](API_SnapStartResponse.md) 对象  
必需：否

 ** State **   <a name="lambda-Type-FunctionConfiguration-State"></a>
函数的当前状态。当状态为 `Inactive`，您可以通过调用函数来重新激活该函数。  
类型：字符串  
有效值：`Pending | Active | Inactive | Failed`  
必需：否

 ** StateReason **   <a name="lambda-Type-FunctionConfiguration-StateReason"></a>
函数当前状态的原因。  
类型：字符串  
必需：否

 ** StateReasonCode **   <a name="lambda-Type-FunctionConfiguration-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 **   <a name="lambda-Type-FunctionConfiguration-Timeout"></a>
Lambda 在停止函数前允许其运行的时长（以秒为单位）。  
类型：整数  
有效范围：最小值为 1。  
必需：否

 ** TracingConfig **   <a name="lambda-Type-FunctionConfiguration-TracingConfig"></a>
函数的 AWS X-Ray 跟踪配置。  
类型：[TracingConfigResponse](API_TracingConfigResponse.md) 对象  
必需：否

 ** Version **   <a name="lambda-Type-FunctionConfiguration-Version"></a>
Lambda 函数的版本。  
类型：字符串  
长度限制：最小长度为 1。长度上限为 1024。  
模式：`(\$LATEST|[0-9]+)`  
必需：否

 ** VpcConfig **   <a name="lambda-Type-FunctionConfiguration-VpcConfig"></a>
函数的网络配置。  
类型：[VpcConfigResponse](API_VpcConfigResponse.md) 对象  
必需：否

## 另请参阅
<a name="API_FunctionConfiguration_SeeAlso"></a>

有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容：
+  [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/FunctionConfiguration) 
+  [适用于 Go 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/FunctionConfiguration) 
+  [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/FunctionConfiguration) 
+  [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/FunctionConfiguration) 