# Runtime

Lambda function runtime environment.

If you need to use a runtime name that doesn't exist as a static member, you
can instantiate a `Runtime` object, e.g: `new Runtime('nodejs99.99')`.

For NodeJS lambda functions, it is recommended to use the latest LTS NodeJS runtime available
(`Runtime.NODEJS_LATEST`) to keep the lambda function up-to-date.

Obtainable from: Runtime.DOTNET_10, Runtime.DOTNET_6, Runtime.DOTNET_8, Runtime.DOTNET_9, Runtime.DOTNET_CORE_1, Runtime.DOTNET_CORE_2, Runtime.DOTNET_CORE_2_1, Runtime.DOTNET_CORE_3_1, Runtime.FROM_IMAGE, Runtime.GO_1_X, Runtime.JAVA_11, Runtime.JAVA_11_AL2023, Runtime.JAVA_17, Runtime.JAVA_17_AL2023, Runtime.JAVA_21, Runtime.JAVA_25, Runtime.JAVA_8, Runtime.JAVA_8_AL2023, Runtime.JAVA_8_CORRETTO, Runtime.NODEJS, Runtime.NODEJS_10_X, Runtime.NODEJS_12_X, Runtime.NODEJS_14_X, Runtime.NODEJS_16_X, Runtime.NODEJS_18_X, Runtime.NODEJS_20_X, Runtime.NODEJS_22_X, Runtime.NODEJS_24_X, Runtime.NODEJS_26_X, Runtime.NODEJS_4_3, Runtime.NODEJS_6_10, Runtime.NODEJS_8_10, Runtime.NODEJS_LATEST, Runtime.PROVIDED, Runtime.PROVIDED_AL2, Runtime.PROVIDED_AL2023, Runtime.PYTHON_2_7, Runtime.PYTHON_3_10, Runtime.PYTHON_3_11, Runtime.PYTHON_3_12, Runtime.PYTHON_3_13, Runtime.PYTHON_3_14, Runtime.PYTHON_3_15, Runtime.PYTHON_3_6, Runtime.PYTHON_3_7, Runtime.PYTHON_3_8, Runtime.PYTHON_3_9, Runtime.RUBY_2_5, Runtime.RUBY_2_7, Runtime.RUBY_3_2, Runtime.RUBY_3_3, Runtime.RUBY_3_4, Runtime.RUBY_4_0, Runtime.determineLatestPythonRuntime

- Source: [`aws-lambda/lib/runtime.ts`](https://github.com/aws/aws-cdk/blob/v2.277.0/packages/aws-cdk-lib/aws-lambda/lib/runtime.ts#L57)
- Type last changed: v2.277.0 · 13 Nov 2026

## Example

TypeScript:

```ts
const myFunctionHandler = new lambda.Function(this, 'MyFunction', {
  code: lambda.Code.fromAsset('resource/myfunction'),
  runtime: lambda.Runtime.NODEJS_LATEST,
  handler: 'index.handler',
});

const eventRule = cloudtrail.Trail.onEvent(this, 'MyCloudWatchEvent', {
  target: new targets.LambdaFunction(myFunctionHandler),
});

eventRule.addEventPattern({
  account: ['123456789012'],
  source: ['aws.s3'],
});
```

Python:

```python
my_function_handler = lambda_.Function(self, "MyFunction",
    code=lambda_.Code.from_asset("resource/myfunction"),
    runtime=lambda_.Runtime.NODEJS_LATEST,
    handler="index.handler"
)

event_rule = cloudtrail.Trail.on_event(self, "MyCloudWatchEvent",
    target=targets.LambdaFunction(my_function_handler)
)

event_rule.add_event_pattern(
    account=["123456789012"],
    source=["aws.s3"]
)
```

Java:

```java
Function myFunctionHandler = Function.Builder.create(this, "MyFunction")
        .code(Code.fromAsset("resource/myfunction"))
        .runtime(Runtime.NODEJS_LATEST)
        .handler("index.handler")
        .build();

Rule eventRule = Trail.onEvent(this, "MyCloudWatchEvent", OnEventOptions.builder()
        .target(new LambdaFunction(myFunctionHandler))
        .build());

eventRule.addEventPattern(EventPattern.builder()
        .account(List.of("123456789012"))
        .source(List.of("aws.s3"))
        .build());
```

C# / .NET:

```csharp
// Install: dotnet add package Amazon.CDK.Lib
var myFunctionHandler = new Function(this, "MyFunction", new FunctionProps {
    Code = Code.FromAsset("resource/myfunction"),
    Runtime = Runtime.NODEJS_LATEST,
    Handler = "index.handler"
});

var eventRule = Trail.OnEvent(this, "MyCloudWatchEvent", new OnEventOptions {
    Target = new LambdaFunction(myFunctionHandler)
});

eventRule.AddEventPattern(new EventPattern {
    Account = new [] { "123456789012" },
    Source = new [] { "aws.s3" }
});
```

Golang:

```go
// Install: go get github.com/aws/aws-cdk-go/awscdk/v2
myFunctionHandler := lambda.NewFunction(this, jsii.String("MyFunction"), &FunctionProps{
	Code: lambda.Code_FromAsset(jsii.String("resource/myfunction")),
	Runtime: lambda.Runtime_NODEJS_LATEST(),
	Handler: jsii.String("index.handler"),
})

eventRule := cloudtrail.Trail_OnEvent(this, jsii.String("MyCloudWatchEvent"), &OnEventOptions{
	Target: targets.NewLambdaFunction(myFunctionHandler),
})

eventRule.AddEventPattern(&EventPattern{
	Account: []*string{
		jsii.String("123456789012"),
	},
	Source: []*string{
		jsii.String("aws.s3"),
	},
})
```

## Initializer

TypeScript:

```ts
new Runtime(name: string, family?: RuntimeFamily, props?: LambdaRuntimeProps)
```

Python:

```python
Runtime(name: str, family: typing.Optional[RuntimeFamily] = None, props: typing.Optional[LambdaRuntimeProps] = None)
```

Java:

```java
new Runtime(String name, RuntimeFamily family, LambdaRuntimeProps props)
```

C# / .NET:

```csharp
new Runtime(string name, RuntimeFamily? family = null, LambdaRuntimeProps? props = null)
```

Golang:

```go
NewRuntime(Name *string, Family RuntimeFamily, Props LambdaRuntimeProps)
```

## Properties

- `ALL`: [Runtime](/cdk/api/v2/docs/aws-cdk-lib.aws_lambda.Runtime.html)[] (static) — A list of all known `Runtime`'s.

- `bundlingImage`: [DockerImage](/cdk/api/v2/docs/aws-cdk-lib.DockerImage.html) — The bundling Docker image for this runtime.

- `DOTNET_10`: [Runtime](/cdk/api/v2/docs/aws-cdk-lib.aws_lambda.Runtime.html) (static) — The .NET 10 runtime (dotnet10).

- `DOTNET_6`: [Runtime](/cdk/api/v2/docs/aws-cdk-lib.aws_lambda.Runtime.html) (static) — Legacy runtime no longer supported by AWS Lambda. Migrate to the latest .NET runtime.

- `DOTNET_8`: [Runtime](/cdk/api/v2/docs/aws-cdk-lib.aws_lambda.Runtime.html) (static) — The .NET 8 runtime (dotnet8).

- `DOTNET_9`: [Runtime](/cdk/api/v2/docs/aws-cdk-lib.aws_lambda.Runtime.html) (static) — The .NET 9 runtime (dotnet9).

- `DOTNET_CORE_1`: [Runtime](/cdk/api/v2/docs/aws-cdk-lib.aws_lambda.Runtime.html) (static) — Legacy runtime no longer supported by AWS Lambda. Migrate to the latest .NET Core runtime.

- `DOTNET_CORE_2`: [Runtime](/cdk/api/v2/docs/aws-cdk-lib.aws_lambda.Runtime.html) (static) — Legacy runtime no longer supported by AWS Lambda. Migrate to the latest .NET Core runtime.

- `DOTNET_CORE_2_1`: [Runtime](/cdk/api/v2/docs/aws-cdk-lib.aws_lambda.Runtime.html) (static) — Legacy runtime no longer supported by AWS Lambda. Migrate to the latest .NET Core runtime.

- `DOTNET_CORE_3_1`: [Runtime](/cdk/api/v2/docs/aws-cdk-lib.aws_lambda.Runtime.html) (static) — Legacy runtime no longer supported by AWS Lambda. Migrate to the latest .NET Core runtime.

- `family`: [RuntimeFamily](/cdk/api/v2/docs/aws-cdk-lib.aws_lambda.RuntimeFamily.html) — The runtime family.

- `FROM_IMAGE`: [Runtime](/cdk/api/v2/docs/aws-cdk-lib.aws_lambda.Runtime.html) (static) — A special runtime entry to be used when function is using a docker image.

- `GO_1_X`: [Runtime](/cdk/api/v2/docs/aws-cdk-lib.aws_lambda.Runtime.html) (static) — Legacy runtime no longer supported by AWS Lambda. Migrate to the PROVIDED_AL2023 runtime.

- `isVariable`: boolean — Enabled for runtime enums that always target the latest available.

- `JAVA_11`: [Runtime](/cdk/api/v2/docs/aws-cdk-lib.aws_lambda.Runtime.html) (static) — The Java 11 runtime (java11).

- `JAVA_11_AL2023`: [Runtime](/cdk/api/v2/docs/aws-cdk-lib.aws_lambda.Runtime.html) (static) — The Java 11 AL2023 runtime (java11.al2023).

- `JAVA_17`: [Runtime](/cdk/api/v2/docs/aws-cdk-lib.aws_lambda.Runtime.html) (static) — The Java 17 runtime (java17).

- `JAVA_17_AL2023`: [Runtime](/cdk/api/v2/docs/aws-cdk-lib.aws_lambda.Runtime.html) (static) — The Java 17 AL2023 runtime (java17.al2023).

- `JAVA_21`: [Runtime](/cdk/api/v2/docs/aws-cdk-lib.aws_lambda.Runtime.html) (static) — The Java 21 runtime (java21).

- `JAVA_25`: [Runtime](/cdk/api/v2/docs/aws-cdk-lib.aws_lambda.Runtime.html) (static) — The Java 25 runtime (java25).

- `JAVA_8`: [Runtime](/cdk/api/v2/docs/aws-cdk-lib.aws_lambda.Runtime.html) (static) — Legacy runtime no longer supported by AWS Lambda. Migrate to the latest Java runtime.

- `JAVA_8_AL2023`: [Runtime](/cdk/api/v2/docs/aws-cdk-lib.aws_lambda.Runtime.html) (static) — The Java 8 AL2023 runtime (java8.al2023).

- `JAVA_8_CORRETTO`: [Runtime](/cdk/api/v2/docs/aws-cdk-lib.aws_lambda.Runtime.html) (static) — The Java 8 Corretto runtime (java8.al2).

- `name`: string — The name of this runtime, as expected by the Lambda resource.

- `NODEJS`: [Runtime](/cdk/api/v2/docs/aws-cdk-lib.aws_lambda.Runtime.html) (static) — Legacy runtime no longer supported by AWS Lambda. Migrate to the latest NodeJS runtime.

- `NODEJS_10_X`: [Runtime](/cdk/api/v2/docs/aws-cdk-lib.aws_lambda.Runtime.html) (static) — Legacy runtime no longer supported by AWS Lambda. Migrate to the latest NodeJS runtime.

- `NODEJS_12_X`: [Runtime](/cdk/api/v2/docs/aws-cdk-lib.aws_lambda.Runtime.html) (static) — Legacy runtime no longer supported by AWS Lambda. Migrate to the latest NodeJS runtime.

- `NODEJS_14_X`: [Runtime](/cdk/api/v2/docs/aws-cdk-lib.aws_lambda.Runtime.html) (static) — Legacy runtime no longer supported by AWS Lambda. Migrate to the latest NodeJS runtime.

- `NODEJS_16_X`: [Runtime](/cdk/api/v2/docs/aws-cdk-lib.aws_lambda.Runtime.html) (static) — Legacy runtime no longer supported by AWS Lambda. Migrate to the latest NodeJS runtime.

- `NODEJS_18_X`: [Runtime](/cdk/api/v2/docs/aws-cdk-lib.aws_lambda.Runtime.html) (static) — Legacy runtime no longer supported by AWS Lambda. Migrate to the latest NodeJS runtime.

- `NODEJS_20_X`: [Runtime](/cdk/api/v2/docs/aws-cdk-lib.aws_lambda.Runtime.html) (static) — The NodeJS 20.x runtime (nodejs20.x).

- `NODEJS_22_X`: [Runtime](/cdk/api/v2/docs/aws-cdk-lib.aws_lambda.Runtime.html) (static) — The NodeJS 22.x runtime (nodejs22.x).

- `NODEJS_24_X`: [Runtime](/cdk/api/v2/docs/aws-cdk-lib.aws_lambda.Runtime.html) (static) — The NodeJS 24.x runtime (nodejs24.x).

- `NODEJS_26_X`: [Runtime](/cdk/api/v2/docs/aws-cdk-lib.aws_lambda.Runtime.html) (static) — The NodeJS 26.x runtime (nodejs26.x).

- `NODEJS_4_3`: [Runtime](/cdk/api/v2/docs/aws-cdk-lib.aws_lambda.Runtime.html) (static) — Legacy runtime no longer supported by AWS Lambda. Migrate to the latest NodeJS runtime.

- `NODEJS_6_10`: [Runtime](/cdk/api/v2/docs/aws-cdk-lib.aws_lambda.Runtime.html) (static) — Legacy runtime no longer supported by AWS Lambda. Migrate to the latest NodeJS runtime.

- `NODEJS_8_10`: [Runtime](/cdk/api/v2/docs/aws-cdk-lib.aws_lambda.Runtime.html) (static) — Legacy runtime no longer supported by AWS Lambda. Migrate to the latest NodeJS runtime.

- `NODEJS_LATEST`: [Runtime](/cdk/api/v2/docs/aws-cdk-lib.aws_lambda.Runtime.html) (static) — The latest NodeJS version currently available in ALL regions (not necessarily the latest NodeJS version available in YOUR region).

- `PROVIDED`: [Runtime](/cdk/api/v2/docs/aws-cdk-lib.aws_lambda.Runtime.html) (static) — Legacy runtime no longer supported by AWS Lambda. Migrate to the latest provided.al2023 runtime.

- `PROVIDED_AL2`: [Runtime](/cdk/api/v2/docs/aws-cdk-lib.aws_lambda.Runtime.html) (static) — The custom provided runtime with Amazon Linux 2 (provided.al2).

- `PROVIDED_AL2023`: [Runtime](/cdk/api/v2/docs/aws-cdk-lib.aws_lambda.Runtime.html) (static) — The custom provided runtime with Amazon Linux 2023 (provided.al2023).

- `PYTHON_2_7`: [Runtime](/cdk/api/v2/docs/aws-cdk-lib.aws_lambda.Runtime.html) (static) — Legacy runtime no longer supported by AWS Lambda. Migrate to the latest Python runtime.

- `PYTHON_3_10`: [Runtime](/cdk/api/v2/docs/aws-cdk-lib.aws_lambda.Runtime.html) (static) — The Python 3.10 runtime (python3.10).

- `PYTHON_3_11`: [Runtime](/cdk/api/v2/docs/aws-cdk-lib.aws_lambda.Runtime.html) (static) — The Python 3.11 runtime (python3.11).

- `PYTHON_3_12`: [Runtime](/cdk/api/v2/docs/aws-cdk-lib.aws_lambda.Runtime.html) (static) — The Python 3.12 runtime (python3.12).

- `PYTHON_3_13`: [Runtime](/cdk/api/v2/docs/aws-cdk-lib.aws_lambda.Runtime.html) (static) — The Python 3.13 runtime (python3.13).

- `PYTHON_3_14`: [Runtime](/cdk/api/v2/docs/aws-cdk-lib.aws_lambda.Runtime.html) (static) — The Python 3.14 runtime (python3.14).

- `PYTHON_3_15`: [Runtime](/cdk/api/v2/docs/aws-cdk-lib.aws_lambda.Runtime.html) (static) — The Python 3.15 runtime (python3.15).

- `PYTHON_3_6`: [Runtime](/cdk/api/v2/docs/aws-cdk-lib.aws_lambda.Runtime.html) (static) — Legacy runtime no longer supported by AWS Lambda. Migrate to the latest Python runtime.

  The Python 3.6 runtime is deprecated as of July 2022.

- `PYTHON_3_7`: [Runtime](/cdk/api/v2/docs/aws-cdk-lib.aws_lambda.Runtime.html) (static) — Legacy runtime no longer supported by AWS Lambda. Migrate to the latest Python runtime.

- `PYTHON_3_8`: [Runtime](/cdk/api/v2/docs/aws-cdk-lib.aws_lambda.Runtime.html) (static) — Legacy runtime no longer supported by AWS Lambda. Migrate to the latest Python runtime.

- `PYTHON_3_9`: [Runtime](/cdk/api/v2/docs/aws-cdk-lib.aws_lambda.Runtime.html) (static) — Legacy runtime no longer supported by AWS Lambda. Migrate to the latest Python runtime.

- `RUBY_2_5`: [Runtime](/cdk/api/v2/docs/aws-cdk-lib.aws_lambda.Runtime.html) (static) — Legacy runtime no longer supported by AWS Lambda. Migrate to the latest Ruby runtime.

- `RUBY_2_7`: [Runtime](/cdk/api/v2/docs/aws-cdk-lib.aws_lambda.Runtime.html) (static) — Legacy runtime no longer supported by AWS Lambda. Migrate to the latest Ruby runtime.

- `RUBY_3_2`: [Runtime](/cdk/api/v2/docs/aws-cdk-lib.aws_lambda.Runtime.html) (static) — The Ruby 3.2 runtime (ruby3.2).

- `RUBY_3_3`: [Runtime](/cdk/api/v2/docs/aws-cdk-lib.aws_lambda.Runtime.html) (static) — The Ruby 3.3 runtime (ruby3.3).

- `RUBY_3_4`: [Runtime](/cdk/api/v2/docs/aws-cdk-lib.aws_lambda.Runtime.html) (static) — The Ruby 3.4 runtime (ruby3.4).

- `RUBY_4_0`: [Runtime](/cdk/api/v2/docs/aws-cdk-lib.aws_lambda.Runtime.html) (static) — The Ruby 4.0 runtime (ruby4.0).

- `supportsCodeGuruProfiling`: boolean — Whether this runtime is integrated with and supported for profiling using Amazon CodeGuru Profiler.

- `supportsInlineCode`: boolean — Whether the ``ZipFile`` (aka inline code) property can be used with this runtime.

- `supportsSnapStart`: boolean — Whether this runtime supports snapstart.

## Methods

- `determineLatestPythonRuntime(scope: Construct): Runtime // chainable` (static) — The latest Python version currently available.

- `runtimeEquals(other: Runtime): boolean`

- `toString(): string`
