Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1466347371.7 KB

Creates a version from the current code and configuration of a function. Use versions to create a snapshot of your function code and configuration that doesn't change.

Lambda doesn't publish a version if the function's configuration and code haven't changed since the last version. Use UpdateFunctionCode or UpdateFunctionConfiguration to update the function before publishing a version.

Clients can invoke versions directly or with an alias. To create an alias, use CreateAlias.

post/2015-03-31/functions/{FunctionName}/versions

Path parameters

FunctionNamestring required
<p>The name of the Lambda function.</p> <p class="title"> <b>Name formats</b> </p> <ul> <li> <p> <b>Function name</b> - <code>MyFunction</code>.</p> </li> <li> <p> <b>Function ARN</b> - <code>arn:aws:lambda:us-west-2:123456789012:function:MyFunction</code>.</p> </li> <li> <p> <b>Partial ARN</b> - <code>123456789012:function:MyFunction</code>.</p> </li> </ul> <p>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>

Request body

CodeSha256string

Only publish a version if the hash value matches the value that's specified. Use this option to avoid publishing a version if the function code has changed since you last updated it. You can get the hash for the version that you uploaded from the output of <a>UpdateFunctionCode</a>.

Descriptionstring

A description for the version to override the description in the function configuration.

RevisionIdstring

Only update the function if the revision ID matches the ID that's specified. Use this option to avoid publishing a version if the function configuration has changed since you last updated it.

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