Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1466347371.7 KB

Returns the version-specific settings of a Lambda function or version. The output includes only options that can vary between versions of a function. To modify these settings, use UpdateFunctionConfiguration.

To get all of a function's details, including function-level settings, use GetFunction.

get/2015-03-31/functions/{FunctionName}/configuration

Path parameters

FunctionNamestring required
<p>The name of the Lambda function, version, or alias.</p> <p class="title"> <b>Name formats</b> </p> <ul> <li> <p> <b>Function name</b> – <code>my-function</code> (name-only), <code>my-function:v1</code> (with alias).</p> </li> <li> <p> <b>Function ARN</b> – <code>arn:aws:lambda:us-west-2:123456789012:function:my-function</code>.</p> </li> <li> <p> <b>Partial ARN</b> – <code>123456789012:function:my-function</code>.</p> </li> </ul> <p>You can append a version number or alias to any of the formats. The length constraint applies only to the full ARN. If you specify only the function name, it is limited to 64 characters in length.</p>

Query parameters

Qualifierstring

Specify a version or alias to get details about a published version of the function.

Response

Success

FunctionNamestring

The name of the function.

FunctionArnstring

The function's Amazon Resource Name (ARN).

Runtime'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'
<p>The identifier of the function's <a href="https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html">runtime</a>. Runtime is required if the deployment package is a .zip file archive.</p> <p>The following list includes deprecated runtimes. For more information, see <a href="https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtime-support-policy">Runtime deprecation policy</a>.</p>
Rolestring

The function's execution role.

Handlerstring

The function that Lambda calls to begin running your function.

CodeSizeinteger

The size of the function's deployment package, in bytes.

Descriptionstring

The function's description.

Timeoutinteger

The amount of time in seconds that Lambda allows a function to run before stopping it.

MemorySizeinteger

The amount of memory available to the function at runtime.

LastModifiedstring

The date and time that the function was last updated, in <a href="https://www.w3.org/TR/NOTE-datetime">ISO-8601 format</a> (YYYY-MM-DDThh:mm:ss.sTZD).

CodeSha256string

The SHA256 hash of the function's deployment package.

Versionstring

The version of the Lambda function.

KMSKeyArnstring

The KMS key that's used to encrypt the function's <a href="https://docs.aws.amazon.com/lambda/latest/dg/configuration-envvars.html#configuration-envvars-encryption">environment variables</a>. When <a href="https://docs.aws.amazon.com/lambda/latest/dg/snapstart-security.html">Lambda SnapStart</a> is activated, this key is also used to encrypt the function's snapshot. This key is returned only if you've configured a customer managed key.

MasterArnstring

For Lambda@Edge functions, the ARN of the main function.

RevisionIdstring

The latest updated revision of the function or alias.

State'Pending' | 'Active' | 'Inactive' | 'Failed'

The current state of the function. When the state is <code>Inactive</code>, you can reactivate the function by invoking it.

StateReasonstring

The reason for the function's current state.

StateReasonCode'Idle' | 'Creating' | 'Restoring' | 'EniLimitExceeded' | 'InsufficientRolePermissions' | 'InvalidConfiguration' | 'InternalError' | 'SubnetOutOfIPAddresses' | 'InvalidSubnet' | 'InvalidSecurityGroup' | 'ImageDeleted' | 'ImageAccessDenied' | 'InvalidImage' | 'KMSKeyAccessDenied' | 'KMSKeyNotFound' | 'InvalidStateKMSKey' | 'DisabledKMSKey' | 'EFSIOError' | 'EFSMountConnectivityError' | 'EFSMountFailure' | 'EFSMountTimeout' | 'InvalidRuntime' | 'InvalidZipFileException' | 'FunctionError'

The reason code for the function's current state. When the code is <code>Creating</code>, you can't invoke or modify the function.

LastUpdateStatus'Successful' | 'Failed' | 'InProgress'

The status of the last update that was performed on the function. This is first set to <code>Successful</code> after function creation completes.

LastUpdateStatusReasonstring

The reason for the last update that was performed on the function.

LastUpdateStatusReasonCode'EniLimitExceeded' | 'InsufficientRolePermissions' | 'InvalidConfiguration' | 'InternalError' | 'SubnetOutOfIPAddresses' | 'InvalidSubnet' | 'InvalidSecurityGroup' | 'ImageDeleted' | 'ImageAccessDenied' | 'InvalidImage' | 'KMSKeyAccessDenied' | 'KMSKeyNotFound' | 'InvalidStateKMSKey' | 'DisabledKMSKey' | 'EFSIOError' | 'EFSMountConnectivityError' | 'EFSMountFailure' | 'EFSMountTimeout' | 'InvalidRuntime' | 'InvalidZipFileException' | 'FunctionError'

The reason code for the last update that was performed on the function.

PackageType'Zip' | 'Image'

The type of deployment package. Set to <code>Image</code> for container image and set <code>Zip</code> for .zip file archive.

SigningProfileVersionArnstring

The ARN of the signing profile version.

SigningJobArnstring

The ARN of the signing job.

ArchitecturesArchitecture[]

The instruction set architecture that the function supports. Architecture is a string array with one of the valid values. The default architecture value is <code>x86_64</code>.