Package com.pulumi.aws.lambda

Class RuntimeManagementConfig

java.lang.Object

com.pulumi.resources.Resource

com.pulumi.resources.CustomResource

com.pulumi.aws.lambda.RuntimeManagementConfig

public class RuntimeManagementConfig
extends com.pulumi.resources.CustomResource

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](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html) 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

 
 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());
 
     }
 }
 
 

### Manual Update

 
 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());
 
     }
 }
 
 

> **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: ```sh $ pulumi import aws:lambda/runtimeManagementConfig:RuntimeManagementConfig example example,$LATEST ```

Nested Class Summary

Nested classes/interfaces inherited from class com.pulumi.resources.CustomResource

com.pulumi.resources.CustomResource.CustomResourceInternal

Nested classes/interfaces inherited from class com.pulumi.resources.Resource

com.pulumi.resources.Resource.LazyField<T extends java.lang.Object>, com.pulumi.resources.Resource.LazyFields, com.pulumi.resources.Resource.ResourceInternal

Field Summary

Fields inherited from class com.pulumi.resources.Resource

childResources, remote

Constructor Summary

Constructors

Constructor	Description
RuntimeManagementConfig(java.lang.String name)
RuntimeManagementConfig(java.lang.String name, RuntimeManagementConfigArgs args)
RuntimeManagementConfig(java.lang.String name, RuntimeManagementConfigArgs args, com.pulumi.resources.CustomResourceOptions options)

Method Summary

Modifier and Type	Method	Description
com.pulumi.core.Output<java.lang.String>	functionArn()
com.pulumi.core.Output<java.lang.String>	functionName()
static RuntimeManagementConfig	get(java.lang.String name, com.pulumi.core.Output<java.lang.String> id, RuntimeManagementConfigState state, com.pulumi.resources.CustomResourceOptions options)	Get an existing Host resource's state with the given name, ID, and optional extra properties used to qualify the lookup.
com.pulumi.core.Output<java.util.Optional<java.lang.String>>	qualifier()
com.pulumi.core.Output<java.lang.String>	region()
com.pulumi.core.Output<java.util.Optional<java.lang.String>>	runtimeVersionArn()
com.pulumi.core.Output<java.util.Optional<java.lang.String>>	updateRuntimeOn()

Methods inherited from class com.pulumi.resources.CustomResource

getId, id, idFuture

Methods inherited from class com.pulumi.resources.Resource

getChildResources, getResourceName, getResourceType, getUrn, pulumiChildResources, pulumiResourceName, pulumiResourceType, urn

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

RuntimeManagementConfig

public RuntimeManagementConfig(java.lang.String name)

Parameters:

name - The _unique_ name of the resulting resource.

RuntimeManagementConfig

public RuntimeManagementConfig(java.lang.String name,
                               RuntimeManagementConfigArgs args)

Parameters:

name - The _unique_ name of the resulting resource.

args - The arguments to use to populate this resource's properties.

RuntimeManagementConfig

public RuntimeManagementConfig(java.lang.String name,
                               RuntimeManagementConfigArgs args,
                               @Nullable
                               com.pulumi.resources.CustomResourceOptions options)

Parameters:

name - The _unique_ name of the resulting resource.

args - The arguments to use to populate this resource's properties.

options - A bag of options that control this resource's behavior.

Method Detail

functionArn

public com.pulumi.core.Output<java.lang.String> functionArn()

Returns:

ARN of the function.

functionName

public com.pulumi.core.Output<java.lang.String> functionName()

Returns:

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

qualifier

public com.pulumi.core.Output<java.util.Optional<java.lang.String>> qualifier()

Returns:

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

region

public com.pulumi.core.Output<java.lang.String> region()

Returns:

Region where this resource will be [managed](https://docs.aws.amazon.com/general/latest/gr/rande.html#regional-endpoints). Defaults to the Region set in the provider configuration.

runtimeVersionArn

public com.pulumi.core.Output<java.util.Optional<java.lang.String>> runtimeVersionArn()

Returns:

ARN of the runtime version. Only required when `updateRuntimeOn` is `Manual`.

updateRuntimeOn

public com.pulumi.core.Output<java.util.Optional<java.lang.String>> updateRuntimeOn()

Returns:

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

get

public static RuntimeManagementConfig get(java.lang.String name,
                                          com.pulumi.core.Output<java.lang.String> id,
                                          @Nullable
                                          RuntimeManagementConfigState state,
                                          @Nullable
                                          com.pulumi.resources.CustomResourceOptions options)

Get an existing Host resource's state with the given name, ID, and optional extra properties used to qualify the lookup.

Parameters:

name - The _unique_ name of the resulting resource.

id - The _unique_ provider ID of the resource to lookup.

state -

options - Optional settings to control the behavior of the CustomResource.