# CustomResourceProviderRuntime

The lambda runtime to use for the resource provider.

This also indicates
which language is used for the handler.

- Source: [`core/lib/custom-resource-provider/custom-resource-provider.ts`](https://github.com/aws/aws-cdk/blob/v2.277.0/packages/aws-cdk-lib/core/lib/custom-resource-provider/custom-resource-provider.ts#L28)
- Type last changed: v2.259.0 · 12 Jun 2026

## Example

TypeScript:

```ts
const provider = CustomResourceProvider.getOrCreateProvider(this, 'Custom::MyCustomResourceType', {
  codeDirectory: `${__dirname}/my-handler`,
  runtime: CustomResourceProviderRuntime.NODEJS_22_X,
});
provider.addToRolePolicy({
  Effect: 'Allow',
  Action: 's3:GetObject',
  Resource: '*',
})
```

Python:

```python
provider = CustomResourceProvider.get_or_create_provider(self, "Custom::MyCustomResourceType",
    code_directory=f"{__dirname}/my-handler",
    runtime=CustomResourceProviderRuntime.NODEJS_22_X
)
provider.add_to_role_policy({
    "Effect": "Allow",
    "Action": "s3:GetObject",
    "Resource": "*"
})
```

Java:

```java
CustomResourceProvider provider = CustomResourceProvider.getOrCreateProvider(this, "Custom::MyCustomResourceType", CustomResourceProviderProps.builder()
        .codeDirectory(String.format("%s/my-handler", __dirname))
        .runtime(CustomResourceProviderRuntime.NODEJS_22_X)
        .build());
provider.addToRolePolicy(Map.of(
        "Effect", "Allow",
        "Action", "s3:GetObject",
        "Resource", "*"));
```

C# / .NET:

```csharp
// Install: dotnet add package Amazon.CDK.Lib
var provider = CustomResourceProvider.GetOrCreateProvider(this, "Custom::MyCustomResourceType", new CustomResourceProviderProps {
    CodeDirectory = $"{__dirname}/my-handler",
    Runtime = CustomResourceProviderRuntime.NODEJS_22_X
});
provider.AddToRolePolicy(new Dictionary<string, string> {
    { "Effect", "Allow" },
    { "Action", "s3:GetObject" },
    { "Resource", "*" }
});
```

Golang:

```go
// Install: go get github.com/aws/aws-cdk-go/awscdk/v2
provider := awscdk.CustomResourceProvider_GetOrCreateProvider(this, jsii.String("Custom::MyCustomResourceType"), &CustomResourceProviderProps{
	CodeDirectory: fmt.Sprintf("%v/my-handler", __dirname),
	Runtime: awscdk.CustomResourceProviderRuntime_NODEJS_22_X,
})
provider.AddToRolePolicy(map[string]*string{
	"Effect": jsii.String("Allow"),
	"Action": jsii.String("s3:GetObject"),
	"Resource": jsii.String("*"),
})
```

## Members

| Member | Description |
| --- | --- |
| `NODEJS_12_X` deprecated | Use latest version |
| `NODEJS_14_X` deprecated | Use latest version |
| `NODEJS_16_X` deprecated | Use latest version |
| `NODEJS_18_X` deprecated | Use latest version |
| `NODEJS_20_X` | Node.js 20.x. |
| `NODEJS_22_X` | Node.js 22.x. |
| `NODEJS_24_X` | Node.js 24.x. |

## Referenced by

- [`CustomResourceProviderProps`](/v2/docs/aws-cdk-lib.CustomResourceProviderProps).runtime
