RuntimeManagementConfig class

Manages an AWS Lambda Runtime Management Config. Use this resource to control how Lambda updates the runtime for your function.

Refer to the AWS Lambda documentation for supported runtimes.

> Note: Deletion of this resource returns the runtime update mode to Auto (the default behavior). To leave the configured runtime management options in-place, use a removed block with the destroy lifecycle set to false.

Example Usage

Basic Usage

import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";

const example = new aws.lambda.RuntimeManagementConfig("example", {
    functionName: exampleAwsLambdaFunction.functionName,
    updateRuntimeOn: "FunctionUpdate",
});

import pulumi
import pulumi_aws as aws

example = aws.lambda_.RuntimeManagementConfig("example",
    function_name=example_aws_lambda_function["functionName"],
    update_runtime_on="FunctionUpdate")

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;

return await Deployment.RunAsync(() =>
{
    var example = new Aws.Lambda.RuntimeManagementConfig("example", new()
    {
        FunctionName = exampleAwsLambdaFunction.FunctionName,
        UpdateRuntimeOn = "FunctionUpdate",
    });

});

package main

import (
	"github.com/pulumi/pulumi-aws/sdk/v7/go/aws/lambda"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := lambda.NewRuntimeManagementConfig(ctx, "example", &lambda.RuntimeManagementConfigArgs{
			FunctionName:    pulumi.Any(exampleAwsLambdaFunction.FunctionName),
			UpdateRuntimeOn: pulumi.String("FunctionUpdate"),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

pulumi {
  required_providers {
    aws = {
      source = "pulumi/aws"
    }
  }
}

resource "aws_lambda_runtimemanagementconfig" "example" {
  function_name     = exampleAwsLambdaFunction.functionName
  update_runtime_on = "FunctionUpdate"
}

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.lambda.RuntimeManagementConfig;
import com.pulumi.aws.lambda.RuntimeManagementConfigArgs;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        var example = new RuntimeManagementConfig("example", RuntimeManagementConfigArgs.builder()
            .functionName(exampleAwsLambdaFunction.functionName())
            .updateRuntimeOn("FunctionUpdate")
            .build());

    }
}

resources:
  example:
    type: aws:lambda:RuntimeManagementConfig
    properties:
      functionName: ${exampleAwsLambdaFunction.functionName}
      updateRuntimeOn: FunctionUpdate

Manual Update

import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";

const example = new aws.lambda.RuntimeManagementConfig("example", {
    functionName: exampleAwsLambdaFunction.functionName,
    updateRuntimeOn: "Manual",
    runtimeVersionArn: "arn:aws:lambda:us-east-1::runtime:abcd1234",
});

import pulumi
import pulumi_aws as aws

example = aws.lambda_.RuntimeManagementConfig("example",
    function_name=example_aws_lambda_function["functionName"],
    update_runtime_on="Manual",
    runtime_version_arn="arn:aws:lambda:us-east-1::runtime:abcd1234")

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;

return await Deployment.RunAsync(() =>
{
    var example = new Aws.Lambda.RuntimeManagementConfig("example", new()
    {
        FunctionName = exampleAwsLambdaFunction.FunctionName,
        UpdateRuntimeOn = "Manual",
        RuntimeVersionArn = "arn:aws:lambda:us-east-1::runtime:abcd1234",
    });

});

package main

import (
	"github.com/pulumi/pulumi-aws/sdk/v7/go/aws/lambda"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := lambda.NewRuntimeManagementConfig(ctx, "example", &lambda.RuntimeManagementConfigArgs{
			FunctionName:      pulumi.Any(exampleAwsLambdaFunction.FunctionName),
			UpdateRuntimeOn:   pulumi.String("Manual"),
			RuntimeVersionArn: pulumi.String("arn:aws:lambda:us-east-1::runtime:abcd1234"),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

pulumi {
  required_providers {
    aws = {
      source = "pulumi/aws"
    }
  }
}

resource "aws_lambda_runtimemanagementconfig" "example" {
  function_name       = exampleAwsLambdaFunction.functionName
  update_runtime_on   = "Manual"
  runtime_version_arn = "arn:aws:lambda:us-east-1::runtime:abcd1234"
}

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.lambda.RuntimeManagementConfig;
import com.pulumi.aws.lambda.RuntimeManagementConfigArgs;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        var example = new RuntimeManagementConfig("example", RuntimeManagementConfigArgs.builder()
            .functionName(exampleAwsLambdaFunction.functionName())
            .updateRuntimeOn("Manual")
            .runtimeVersionArn("arn:aws:lambda:us-east-1::runtime:abcd1234")
            .build());

    }
}

resources:
  example:
    type: aws:lambda:RuntimeManagementConfig
    properties:
      functionName: ${exampleAwsLambdaFunction.functionName}
      updateRuntimeOn: Manual
      runtimeVersionArn: arn:aws:lambda:us-east-1::runtime:abcd1234

> Note: Once the runtime update mode is set to Manual, the aws.lambda.Function runtime cannot be updated. To upgrade a runtime, the updateRuntimeOn argument must be set to Auto or FunctionUpdate prior to changing the function's runtime argument.

Import

Using pulumi import, import Lambda Runtime Management Config using a comma-delimited string combining functionName and qualifier. For example:

$ pulumi import aws:lambda/runtimeManagementConfig:RuntimeManagementConfig example example,$LATEST