Skip to content
v2.275.0

VersionProps Struct ​

Properties for a new Lambda version.

Example ​

ts
declare const fn: lambda.Function;
const version = new lambda.Version(this, 'MyVersion', {
  lambda: fn,
});

Properties ​

codeSha256optionalstringcode_sha256optionalstrcodeSha256optionalStringCodeSha256optionalstringCodeSha256optional*string#
SHA256 of the version of the Lambda source code.

Default: No validation is performed

Specify to validate that you're deploying the right version.

descriptionoptionalstringdescriptionoptionalstrdescriptionoptionalStringDescriptionoptionalstringDescriptionoptional*string#
Description of the version.

Default: Description of the Lambda

lambdaIFunctionlambdaIFunctionlambdaIFunctionLambdaIFunctionLambdaIFunctionrequired#
Function to get the value of.
maxEventAgeoptionalDurationmax_event_ageoptionalDurationmaxEventAgeoptionalDurationMaxEventAgeoptionalDurationMaxEventAgeoptionalDuration= Duration.hours(6)#
The maximum age of a request that Lambda sends to a function for processing.

Minimum: 60 seconds Maximum: 6 hours

maxExecutionEnvironmentsoptionalnumbermax_execution_environmentsoptionalint | floatmaxExecutionEnvironmentsoptionalNumberMaxExecutionEnvironmentsoptionaldoubleMaxExecutionEnvironmentsoptional*float64#
The maximum number of execution environments allowed for this version when published into a capacity provider.

Default: No maximum specified

This setting limits the total number of execution environments that can be created to handle concurrent invocations of this specific version.

minExecutionEnvironmentsoptionalnumbermin_execution_environmentsoptionalint | floatminExecutionEnvironmentsoptionalNumberMinExecutionEnvironmentsoptionaldoubleMinExecutionEnvironmentsoptional*float64#
The minimum number of execution environments to maintain for this version when published into a capacity provider.

Default: 3 execution environments are set to be the minimum

This setting ensures that at least this many execution environments are always available to handle function invocations for this specific version, reducing cold start latency.

onFailureoptionalIDestinationon_failureoptionalIDestinationonFailureoptionalIDestinationOnFailureoptionalIDestinationOnFailureoptionalIDestination#
The destination for failed invocations.

Default: no destination

onSuccessoptionalIDestinationon_successoptionalIDestinationonSuccessoptionalIDestinationOnSuccessoptionalIDestinationOnSuccessoptionalIDestination#
The destination for successful invocations.

Default: no destination

provisionedConcurrentExecutionsoptionalnumberprovisioned_concurrent_executionsoptionalint | floatprovisionedConcurrentExecutionsoptionalNumberProvisionedConcurrentExecutionsoptionaldoubleProvisionedConcurrentExecutionsoptional*float64#
Specifies a provisioned concurrency configuration for a function's version.

Default: No provisioned concurrency

removalPolicyoptionalRemovalPolicyremoval_policyoptionalRemovalPolicyremovalPolicyoptionalRemovalPolicyRemovalPolicyoptionalRemovalPolicyRemovalPolicyoptionalRemovalPolicy= RemovalPolicy.DESTROY#
Whether to retain old versions of this function when a new version is created.
retryAttemptsoptionalnumberretry_attemptsoptionalint | floatretryAttemptsoptionalNumberRetryAttemptsoptionaldoubleRetryAttemptsoptional*float64= 2#
The maximum number of times to retry when the function returns an error.

Minimum: 0 Maximum: 2