pulumi-aws-kotlin/com.pulumi.aws.lambda.kotlin/RuntimeManagementConfig

RuntimeManagementConfig

class RuntimeManagementConfig : KotlinCustomResource

Resource for managing an AWS Lambda Runtime Management Config. Refer to the AWS Lambda documentation for supported runtimes.

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: test.functionName,
    updateRuntimeOn: "FunctionUpdate",
});
Content copied to clipboard
import pulumi
import pulumi_aws as aws
example = aws.lambda_.RuntimeManagementConfig("example",
    function_name=test["functionName"],
    update_runtime_on="FunctionUpdate")
Content copied to clipboard
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 = test.FunctionName,
        UpdateRuntimeOn = "FunctionUpdate",
    });
});
Content copied to clipboard
package main
import (
	"github.com/pulumi/pulumi-aws/sdk/v6/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(test.FunctionName),
			UpdateRuntimeOn: pulumi.String("FunctionUpdate"),
		})
		if err != nil {
			return err
		}
		return nil
	})
}
Content copied to clipboard
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.List;
import java.util.ArrayList;
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(test.functionName())
            .updateRuntimeOn("FunctionUpdate")
            .build());
    }
}
Content copied to clipboard
resources:
  example:
    type: aws:lambda:RuntimeManagementConfig
    properties:
      functionName: ${test.functionName}
      updateRuntimeOn: FunctionUpdate
Content copied to clipboard

Manual Update

import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";
const example = new aws.lambda.RuntimeManagementConfig("example", {
    functionName: test.functionName,
    updateRuntimeOn: "Manual",
    runtimeVersionArn: "arn:aws:lambda:us-east-1::runtime:abcd1234",
});
Content copied to clipboard
import pulumi
import pulumi_aws as aws
example = aws.lambda_.RuntimeManagementConfig("example",
    function_name=test["functionName"],
    update_runtime_on="Manual",
    runtime_version_arn="arn:aws:lambda:us-east-1::runtime:abcd1234")
Content copied to clipboard
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 = test.FunctionName,
        UpdateRuntimeOn = "Manual",
        RuntimeVersionArn = "arn:aws:lambda:us-east-1::runtime:abcd1234",
    });
});
Content copied to clipboard
package main
import (
	"github.com/pulumi/pulumi-aws/sdk/v6/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(test.FunctionName),
			UpdateRuntimeOn:   pulumi.String("Manual"),
			RuntimeVersionArn: pulumi.String("arn:aws:lambda:us-east-1::runtime:abcd1234"),
		})
		if err != nil {
			return err
		}
		return nil
	})
}
Content copied to clipboard
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.List;
import java.util.ArrayList;
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(test.functionName())
            .updateRuntimeOn("Manual")
            .runtimeVersionArn("arn:aws:lambda:us-east-1::runtime:abcd1234")
            .build());
    }
}
Content copied to clipboard
resources:
  example:
    type: aws:lambda:RuntimeManagementConfig
    properties:
      functionName: ${test.functionName}
      updateRuntimeOn: Manual
      runtimeVersionArn: arn:aws:lambda:us-east-1::runtime:abcd1234
Content copied to clipboard

Once the runtime update mode is set to Manual, the aws.lambda.Function runtime cannot be updated. To upgrade a runtime, the update_runtime_on 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 function_name and qualifier. For example:

$ pulumi import aws:lambda/runtimeManagementConfig:RuntimeManagementConfig example my-function,$LATEST
Content copied to clipboard

Properties

Link copied to clipboard
val functionArn: Output<String>

ARN of the function.

Link copied to clipboard
val functionName: Output<String>

Name or ARN of the Lambda function. The following arguments are optional:

Link copied to clipboard
val id: Output<String>
Link copied to clipboard
val pulumiChildResources: Set<KotlinResource>
Link copied to clipboard
Link copied to clipboard
Link copied to clipboard
val qualifier: Output<String>?

Version of the function. This can be $LATEST or a published version number. If omitted, this resource will manage the runtime configuration for $LATEST.

Link copied to clipboard
val runtimeVersionArn: Output<String>?

ARN of the runtime version. Only required when update_runtime_on is Manual.

Link copied to clipboard
val updateRuntimeOn: Output<String>?

Runtime update mode. Valid values are Auto, FunctionUpdate, and Manual. When a function is created, the default mode is Auto.

Link copied to clipboard
val urn: Output<String>