Package com.pulumi.aws.lambdamicrovms

Class Microvm

  • public class Microvm
extends com.pulumi.resources.CustomResource
    Manages an AWS Lambda MicroVMs MicroVM. Use this resource to run a MicroVM from a MicroVM image, which provisions a dedicated HTTPS endpoint and starts your application from the image snapshot. > MicroVMs are immutable. Because the service has no update operation, changing any argument terminates the MicroVM and runs a new one. ## Example Usage ### Basic Usage 
     
 package generated_program;
 
 import com.pulumi.Context;
 import com.pulumi.Pulumi;
 import com.pulumi.core.Output;
 import com.pulumi.aws.lambdamicrovms.Microvm;
 import com.pulumi.aws.lambdamicrovms.MicrovmArgs;
 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 Microvm("example", MicrovmArgs.builder()
             .imageArn(exampleAwsLambdamicrovmsImage.arn())
             .build());
 
     }
 }
    ### With Idle Policy and Logging 
     
 package generated_program;
 
 import com.pulumi.Context;
 import com.pulumi.Pulumi;
 import com.pulumi.core.Output;
 import com.pulumi.aws.lambdamicrovms.Microvm;
 import com.pulumi.aws.lambdamicrovms.MicrovmArgs;
 import com.pulumi.aws.lambdamicrovms.inputs.MicrovmIdlePolicyArgs;
 import com.pulumi.aws.lambdamicrovms.inputs.MicrovmLoggingArgs;
 import com.pulumi.aws.lambdamicrovms.inputs.MicrovmLoggingCloudwatchArgs;
 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 Microvm("example", MicrovmArgs.builder()
             .idlePolicy(MicrovmIdlePolicyArgs.builder()
                 .autoResumeEnabled(true)
                 .maxIdleDurationSeconds(900)
                 .suspendedDurationSeconds(1800)
                 .build())
             .logging(MicrovmLoggingArgs.builder()
                 .cloudwatch(MicrovmLoggingCloudwatchArgs.builder()
                     .logGroup(exampleAwsCloudwatchLogGroup.name())
                     .build())
                 .build())
             .imageArn(exampleAwsLambdamicrovmsImage.arn())
             .executionRoleArn(exampleAwsIamRole.arn())
             .maximumDurationInSeconds(14400)
             .egressNetworkConnectors("arn:aws:lambda:us-east-1:aws:network-connector:aws-network-connector:INTERNET_EGRESS")
             .ingressNetworkConnectors("arn:aws:lambda:us-east-1:aws:network-connector:aws-network-connector:ALL_INGRESS")
             .build());
 
     }
 }
    ## Import ### Identity Schema #### Required * `microvmId` (String) Unique identifier of the MicroVM. #### Optional * `accountId` (String) AWS Account where this resource is managed. * `region` (String) Region where this resource is managed. Using `pulumi import`, import Lambda MicroVMs MicroVM using the `microvmId`. For example: ```sh $ pulumi import aws:lambdamicrovms/microvm:Microvm example mvm-01234567-abcd-ef01-2345-6789abcdef01 ```

    • 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
      Microvm​(java.lang.String name)  
      Microvm​(java.lang.String name, MicrovmArgs args)  
      Microvm​(java.lang.String name, MicrovmArgs args, com.pulumi.resources.CustomResourceOptions options)  

    • Method Summary

      All Methods Static Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      com.pulumi.core.Output<java.util.List<java.lang.String>> egressNetworkConnectors()  
      com.pulumi.core.Output<java.lang.String> endpoint()  
      com.pulumi.core.Output<java.util.Optional<java.lang.String>> executionRoleArn()  
      static Microvm get​(java.lang.String name, com.pulumi.core.Output<java.lang.String> id, MicrovmState 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<MicrovmIdlePolicy>> idlePolicy()  
      com.pulumi.core.Output<java.lang.String> imageArn()  
      com.pulumi.core.Output<java.lang.String> imageVersion()  
      com.pulumi.core.Output<java.util.List<java.lang.String>> ingressNetworkConnectors()  
      com.pulumi.core.Output<java.util.Optional<MicrovmLogging>> logging()  
      com.pulumi.core.Output<java.lang.Integer> maximumDurationInSeconds()  
      com.pulumi.core.Output<java.lang.String> microvmId()  
      com.pulumi.core.Output<java.lang.String> region()  
      com.pulumi.core.Output<java.util.Optional<java.lang.String>> runHookPayload()  
      com.pulumi.core.Output<java.lang.String> startedAt()  
      com.pulumi.core.Output<java.lang.String> state()  
      com.pulumi.core.Output<java.util.Optional<MicrovmTimeouts>> timeouts()  

      • 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

      • Microvm

        public Microvm​(java.lang.String name)
        Parameters:
        name - The _unique_ name of the resulting resource.

      • Microvm

        public Microvm​(java.lang.String name,
               MicrovmArgs args)
        Parameters:
        name - The _unique_ name of the resulting resource.
        args - The arguments to use to populate this resource's properties.

      • Microvm

        public Microvm​(java.lang.String name,
               MicrovmArgs 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

      • egressNetworkConnectors

        public com.pulumi.core.Output<java.util.List<java.lang.String>> egressNetworkConnectors()
        Returns:
        List of egress network connector ARNs for outbound connectivity. Changing this value creates a new resource.

      • endpoint

        public com.pulumi.core.Output<java.lang.String> endpoint()
        Returns:
        HTTPS endpoint URL for communicating with the MicroVM.

      • executionRoleArn

        public com.pulumi.core.Output<java.util.Optional<java.lang.String>> executionRoleArn()
        Returns:
        ARN of the IAM role assumed by the MicroVM during execution. Changing this value creates a new resource.

      • idlePolicy

        public com.pulumi.core.Output<java.util.Optional<MicrovmIdlePolicy>> idlePolicy()
        Returns:
        Configuration controlling automatic suspend and resume behavior. See below. Changing this value creates a new resource.

      • imageArn

        public com.pulumi.core.Output<java.lang.String> imageArn()
        Returns:
        ARN of the MicroVM image to run. Changing this value creates a new resource. The following arguments are optional:

      • imageVersion

        public com.pulumi.core.Output<java.lang.String> imageVersion()
        Returns:
        Version of the MicroVM image to run. Defaults to the latest active version. Changing this value creates a new resource.

      • ingressNetworkConnectors

        public com.pulumi.core.Output<java.util.List<java.lang.String>> ingressNetworkConnectors()
        Returns:
        List of ingress network connector ARNs for inbound connectivity. Changing this value creates a new resource.

      • logging

        public com.pulumi.core.Output<java.util.Optional<MicrovmLogging>> logging()
        Returns:
        Logging configuration for the MicroVM. See below. Changing this value creates a new resource.

      • maximumDurationInSeconds

        public com.pulumi.core.Output<java.lang.Integer> maximumDurationInSeconds()
        Returns:
        Maximum duration in seconds that the MicroVM can exist before the platform terminates it. Valid range: `1`–`28800` (8 hours). Changing this value creates a new resource.

      • microvmId

        public com.pulumi.core.Output<java.lang.String> microvmId()
        Returns:
        Unique identifier of the MicroVM.

      • 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.

      • runHookPayload

        public com.pulumi.core.Output<java.util.Optional<java.lang.String>> runHookPayload()
        Returns:
        String payload (maximum 16 KB) delivered to the `/run` lifecycle hook when the MicroVM starts. Changing this value creates a new resource.

      • startedAt

        public com.pulumi.core.Output<java.lang.String> startedAt()
        Returns:
        Timestamp when the MicroVM first started, in RFC 3339 format.

      • state

        public com.pulumi.core.Output<java.lang.String> state()
        Returns:
        Current lifecycle state of the MicroVM (e.g., `RUNNING`).

      • timeouts

        public com.pulumi.core.Output<java.util.Optional<MicrovmTimeouts>> timeouts()

      • get

        public static Microvm get​(java.lang.String name,
                          com.pulumi.core.Output<java.lang.String> id,
                          @Nullable
                          MicrovmState 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.