1. Registry
  2. Packages
  3. AWS
  4. API Docs
  5. lambdamicrovms
  6. Image
Viewing docs for AWS v7.46.0
published on Thursday, Sep 10, 2026 by Pulumi
aws logo aws logo
Viewing docs for AWS v7.46.0
published on Thursday, Sep 10, 2026 by Pulumi

    Manages an AWS Lambda MicroVMs Image. Use this resource to define the base image, application code, and runtime configuration from which MicroVMs are launched.

    Example Usage

    Basic Usage

    import * as pulumi from "@pulumi/pulumi";
    import * as aws from "@pulumi/aws";
    
    const current = aws.getPartition({});
    const currentGetRegion = aws.getRegion({});
    const example = new aws.iam.Role("example", {
        name: "example",
        assumeRolePolicy: JSON.stringify({
            Version: "2012-10-17",
            Statement: [{
                Action: "sts:AssumeRole",
                Effect: "Allow",
                Principal: {
                    Service: "lambda.amazonaws.com",
                },
            }],
        }),
    });
    const exampleBucket = new aws.s3.Bucket("example", {bucket: "example"});
    const exampleRolePolicy = new aws.iam.RolePolicy("example", {
        name: "example",
        role: example.id,
        policy: pulumi.jsonStringify({
            Version: "2012-10-17",
            Statement: [{
                Action: ["s3:GetObject"],
                Effect: "Allow",
                Resource: pulumi.interpolate`${exampleBucket.arn}/*`,
            }],
        }),
    });
    const exampleBucketObjectv2 = new aws.s3.BucketObjectv2("example", {
        bucket: exampleBucket.bucket,
        key: "code.zip",
        source: new pulumi.asset.FileAsset("code.zip"),
    });
    const exampleImage = new aws.lambdamicrovms.Image("example", {
        codeArtifact: {
            uri: pulumi.interpolate`s3://${exampleBucket.bucket}/${exampleBucketObjectv2.key}`,
        },
        name: "example",
        baseImageArn: Promise.all([current, currentGetRegion]).then(([current, currentGetRegion]) => `arn:${current.partition}:lambda:${currentGetRegion.region}:aws:microvm-image:al2023-1`),
        buildRoleArn: example.arn,
    });
    
    import pulumi
    import json
    import pulumi_aws as aws
    
    current = aws.get_partition()
    current_get_region = aws.get_region()
    example = aws.iam.Role("example",
        name="example",
        assume_role_policy=json.dumps({
            "Version": "2012-10-17",
            "Statement": [{
                "Action": "sts:AssumeRole",
                "Effect": "Allow",
                "Principal": {
                    "Service": "lambda.amazonaws.com",
                },
            }],
        }))
    example_bucket = aws.s3.Bucket("example", bucket="example")
    example_role_policy = aws.iam.RolePolicy("example",
        name="example",
        role=example.id,
        policy=pulumi.Output.json_dumps({
            "Version": "2012-10-17",
            "Statement": [{
                "Action": ["s3:GetObject"],
                "Effect": "Allow",
                "Resource": example_bucket.arn.apply(lambda arn: f"{arn}/*"),
            }],
        }))
    example_bucket_objectv2 = aws.s3.BucketObjectv2("example",
        bucket=example_bucket.bucket,
        key="code.zip",
        source=pulumi.FileAsset("code.zip"))
    example_image = aws.lambdamicrovms.Image("example",
        code_artifact={
            "uri": pulumi.Output.all(
                bucket=example_bucket.bucket,
                key=example_bucket_objectv2.key
    ).apply(lambda resolved_outputs: f"s3://{resolved_outputs['bucket']}/{resolved_outputs['key']}")
    ,
        },
        name="example",
        base_image_arn=f"arn:{current.partition}:lambda:{current_get_region.region}:aws:microvm-image:al2023-1",
        build_role_arn=example.arn)
    
    package main
    
    import (
    	"encoding/json"
    	"fmt"
    
    	"github.com/pulumi/pulumi-aws/sdk/v7/go/aws"
    	"github.com/pulumi/pulumi-aws/sdk/v7/go/aws/iam"
    	"github.com/pulumi/pulumi-aws/sdk/v7/go/aws/lambdamicrovms"
    	"github.com/pulumi/pulumi-aws/sdk/v7/go/aws/s3"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		current, err := aws.GetPartition(ctx, &aws.GetPartitionArgs{}, nil)
    		if err != nil {
    			return err
    		}
    		currentGetRegion, err := aws.GetRegion(ctx, &aws.GetRegionArgs{}, nil)
    		if err != nil {
    			return err
    		}
    		tmpJSON0, err := json.Marshal(map[string]interface{}{
    			"Version": "2012-10-17",
    			"Statement": []map[string]interface{}{
    				map[string]interface{}{
    					"Action": "sts:AssumeRole",
    					"Effect": "Allow",
    					"Principal": map[string]string{
    						"Service": "lambda.amazonaws.com",
    					},
    				},
    			},
    		})
    		if err != nil {
    			return err
    		}
    		json0 := string(tmpJSON0)
    		example, err := iam.NewRole(ctx, "example", &iam.RoleArgs{
    			Name:             pulumi.String("example"),
    			AssumeRolePolicy: pulumi.String(json0),
    		})
    		if err != nil {
    			return err
    		}
    		exampleBucket, err := s3.NewBucket(ctx, "example", &s3.BucketArgs{
    			Bucket: pulumi.String("example"),
    		})
    		if err != nil {
    			return err
    		}
    		_, err = iam.NewRolePolicy(ctx, "example", &iam.RolePolicyArgs{
    			Name: pulumi.String("example"),
    			Role: example.ID().ToIDOutput().ToStringOutput(),
    			Policy: exampleBucket.Arn.ApplyT(func(arn string) (pulumi.String, error) {
    				var _zero pulumi.String
    				tmpJSON1, err := json.Marshal(map[string]interface{}{
    					"Version": "2012-10-17",
    					"Statement": []map[string]interface{}{
    						map[string]interface{}{
    							"Action": []string{
    								"s3:GetObject",
    							},
    							"Effect":   "Allow",
    							"Resource": fmt.Sprintf("%v/*", arn),
    						},
    					},
    				})
    				if err != nil {
    					return _zero, err
    				}
    				json1 := string(tmpJSON1)
    				return pulumi.String(json1), nil
    			}).(pulumi.StringOutput),
    		})
    		if err != nil {
    			return err
    		}
    		exampleBucketObjectv2, err := s3.NewBucketObjectv2(ctx, "example", &s3.BucketObjectv2Args{
    			Bucket: exampleBucket.Bucket,
    			Key:    pulumi.String("code.zip"),
    			Source: pulumi.NewFileAsset("code.zip"),
    		})
    		if err != nil {
    			return err
    		}
    		_, err = lambdamicrovms.NewImage(ctx, "example", &lambdamicrovms.ImageArgs{
    			CodeArtifact: &lambdamicrovms.ImageCodeArtifactArgs{
    				Uri: pulumi.All(exampleBucket.Bucket, exampleBucketObjectv2.Key).ApplyT(func(_args []interface{}) (string, error) {
    					bucket := _args[0].(string)
    					key := _args[1].(string)
    					return fmt.Sprintf("s3://%v/%v", bucket, key), nil
    				}).(pulumi.StringOutput),
    			},
    			Name:         pulumi.String("example"),
    			BaseImageArn: pulumi.Sprintf("arn:%v:lambda:%v:aws:microvm-image:al2023-1", current.Partition, currentGetRegion.Region),
    			BuildRoleArn: example.Arn,
    		})
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using System.Text.Json;
    using Pulumi;
    using Aws = Pulumi.Aws;
    
    return await Deployment.RunAsync(() => 
    {
        var current = Aws.GetPartition.Invoke();
    
        var currentGetRegion = Aws.GetRegion.Invoke();
    
        var example = new Aws.Iam.Role("example", new()
        {
            Name = "example",
            AssumeRolePolicy = JsonSerializer.Serialize(new Dictionary<string, object?>
            {
                ["Version"] = "2012-10-17",
                ["Statement"] = new[]
                {
                    new Dictionary<string, object?>
                    {
                        ["Action"] = "sts:AssumeRole",
                        ["Effect"] = "Allow",
                        ["Principal"] = new Dictionary<string, object?>
                        {
                            ["Service"] = "lambda.amazonaws.com",
                        },
                    },
                },
            }),
        });
    
        var exampleBucket = new Aws.S3.Bucket("example", new()
        {
            BucketName = "example",
        });
    
        var exampleRolePolicy = new Aws.Iam.RolePolicy("example", new()
        {
            Name = "example",
            Role = example.Id,
            Policy = Output.JsonSerialize(Output.Create(new Dictionary<string, object?>
            {
                ["Version"] = "2012-10-17",
                ["Statement"] = new[]
                {
                    new Dictionary<string, object?>
                    {
                        ["Action"] = new[]
                        {
                            "s3:GetObject",
                        },
                        ["Effect"] = "Allow",
                        ["Resource"] = exampleBucket.Arn.Apply(arn => $"{arn}/*"),
                    },
                },
            })),
        });
    
        var exampleBucketObjectv2 = new Aws.S3.BucketObjectv2("example", new()
        {
            Bucket = exampleBucket.BucketName,
            Key = "code.zip",
            Source = new FileAsset("code.zip"),
        });
    
        var exampleImage = new Aws.LambdaMicroVMs.Image("example", new()
        {
            CodeArtifact = new Aws.LambdaMicroVMs.Inputs.ImageCodeArtifactArgs
            {
                Uri = Output.Tuple(exampleBucket.BucketName, exampleBucketObjectv2.Key).Apply(values =>
                {
                    var bucket = values.Item1;
                    var key = values.Item2;
                    return $"s3://{bucket}/{key}";
                }),
            },
            Name = "example",
            BaseImageArn = Output.Tuple(current, currentGetRegion).Apply(values =>
            {
                var current = values.Item1;
                var currentGetRegion = values.Item2;
                return $"arn:{current.Apply(getPartitionResult => getPartitionResult.Partition)}:lambda:{currentGetRegion.Apply(getRegionResult => getRegionResult.Region)}:aws:microvm-image:al2023-1";
            }),
            BuildRoleArn = example.Arn,
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.aws.AwsFunctions;
    import com.pulumi.aws.inputs.GetPartitionArgs;
    import com.pulumi.aws.inputs.GetRegionArgs;
    import com.pulumi.aws.iam.Role;
    import com.pulumi.aws.iam.RoleArgs;
    import com.pulumi.aws.s3.Bucket;
    import com.pulumi.aws.s3.BucketArgs;
    import com.pulumi.aws.iam.RolePolicy;
    import com.pulumi.aws.iam.RolePolicyArgs;
    import com.pulumi.aws.s3.BucketObjectv2;
    import com.pulumi.aws.s3.BucketObjectv2Args;
    import com.pulumi.aws.lambdamicrovms.Image;
    import com.pulumi.aws.lambdamicrovms.ImageArgs;
    import com.pulumi.aws.lambdamicrovms.inputs.ImageCodeArtifactArgs;
    import com.pulumi.asset.FileAsset;
    import static com.pulumi.codegen.internal.Serialization.*;
    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) {
            final var current = AwsFunctions.getPartition(GetPartitionArgs.builder()
                .build());
    
            final var currentGetRegion = AwsFunctions.getRegion(GetRegionArgs.builder()
                .build());
    
            var example = new Role("example", RoleArgs.builder()
                .name("example")
                .assumeRolePolicy(serializeJson(
                    jsonObject(
                        jsonProperty("Version", "2012-10-17"),
                        jsonProperty("Statement", jsonArray(jsonObject(
                            jsonProperty("Action", "sts:AssumeRole"),
                            jsonProperty("Effect", "Allow"),
                            jsonProperty("Principal", jsonObject(
                                jsonProperty("Service", "lambda.amazonaws.com")
                            ))
                        )))
                    )))
                .build());
    
            var exampleBucket = new Bucket("exampleBucket", BucketArgs.builder()
                .bucket("example")
                .build());
    
            var exampleRolePolicy = new RolePolicy("exampleRolePolicy", RolePolicyArgs.builder()
                .name("example")
                .role(example.id())
                .policy(exampleBucket.arn().applyValue(_arn -> serializeJson(
                    jsonObject(
                        jsonProperty("Version", "2012-10-17"),
                        jsonProperty("Statement", jsonArray(jsonObject(
                            jsonProperty("Action", jsonArray("s3:GetObject")),
                            jsonProperty("Effect", "Allow"),
                            jsonProperty("Resource", String.format("%s/*", _arn))
                        )))
                    ))))
                .build());
    
            var exampleBucketObjectv2 = new BucketObjectv2("exampleBucketObjectv2", BucketObjectv2Args.builder()
                .bucket(exampleBucket.bucket())
                .key("code.zip")
                .source(new FileAsset("code.zip"))
                .build());
    
            var exampleImage = new Image("exampleImage", ImageArgs.builder()
                .codeArtifact(ImageCodeArtifactArgs.builder()
                    .uri(Output.tuple(exampleBucket.bucket(), exampleBucketObjectv2.key()).applyValue(values -> {
                        var bucket = values.t1;
                        var key = values.t2;
                        return String.format("s3://%s/%s", bucket,key);
                    }))
                    .build())
                .name("example")
                .baseImageArn(String.format("arn:%s:lambda:%s:aws:microvm-image:al2023-1", current.partition(),currentGetRegion.region()))
                .buildRoleArn(example.arn())
                .build());
    
        }
    }
    
    resources:
      example:
        type: aws:iam:Role
        properties:
          name: example
          assumeRolePolicy:
            fn::toJSON:
              Version: 2012-10-17
              Statement:
                - Action: sts:AssumeRole
                  Effect: Allow
                  Principal:
                    Service: lambda.amazonaws.com
      exampleRolePolicy:
        type: aws:iam:RolePolicy
        name: example
        properties:
          name: example
          role: ${example.id}
          policy:
            fn::toJSON:
              Version: 2012-10-17
              Statement:
                - Action:
                    - s3:GetObject
                  Effect: Allow
                  Resource: ${exampleBucket.arn}/*
      exampleBucket:
        type: aws:s3:Bucket
        name: example
        properties:
          bucket: example
      exampleBucketObjectv2:
        type: aws:s3:BucketObjectv2
        name: example
        properties:
          bucket: ${exampleBucket.bucket}
          key: code.zip
          source:
            fn::fileAsset: code.zip
      exampleImage:
        type: aws:lambdamicrovms:Image
        name: example
        properties:
          codeArtifact:
            uri: s3://${exampleBucket.bucket}/${exampleBucketObjectv2.key}
          name: example
          baseImageArn: arn:${current.partition}:lambda:${currentGetRegion.region}:aws:microvm-image:al2023-1
          buildRoleArn: ${example.arn}
    variables:
      current:
        fn::invoke:
          function: aws:getPartition
          arguments: {}
      currentGetRegion:
        fn::invoke:
          function: aws:getRegion
          arguments: {}
    
    pulumi {
      required_providers {
        aws = {
          source = "pulumi/aws"
        }
      }
    }
    
    data "aws_getpartition" "current" {
    }
    data "aws_getregion" "currentGetRegion" {
    }
    
    resource "aws_iam_role" "example" {
      name = "example"
      assume_role_policy = jsonencode({
        "Version" = "2012-10-17"
        "Statement" = [{
          "Action" = "sts:AssumeRole"
          "Effect" = "Allow"
          "Principal" = {
            "Service" = "lambda.amazonaws.com"
          }
        }]
      })
    }
    resource "aws_iam_rolepolicy" "example" {
      name = "example"
      role = aws_iam_role.example.id
      policy = jsonencode({
        "Version" = "2012-10-17"
        "Statement" = [{
          "Action"   = ["s3:GetObject"]
          "Effect"   = "Allow"
          "Resource" ="${aws_s3_bucket.example.arn}/*"
        }]
      })
    }
    resource "aws_s3_bucket" "example" {
      bucket = "example"
    }
    resource "aws_s3_bucketobjectv2" "example" {
      bucket = aws_s3_bucket.example.bucket
      key    = "code.zip"
      source = fileAsset("code.zip")
    }
    resource "aws_lambdamicrovms_image" "example" {
      code_artifact = {
        uri ="s3://${aws_s3_bucket.example.bucket}/${aws_s3_bucketobjectv2.example.key}"
      }
      name           = "example"
      base_image_arn ="arn:${data.aws_getpartition.current.partition}:lambda:${data.aws_getregion.currentGetRegion.region}:aws:microvm-image:al2023-1"
      build_role_arn = aws_iam_role.example.arn
    }
    

    Create Image Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new Image(name: string, args: ImageArgs, opts?: CustomResourceOptions);
    @overload
    def Image(resource_name: str,
              args: ImageArgs,
              opts: Optional[ResourceOptions] = None)
    
    @overload
    def Image(resource_name: str,
              opts: Optional[ResourceOptions] = None,
              build_role_arn: Optional[str] = None,
              base_image_arn: Optional[str] = None,
              code_artifact: Optional[ImageCodeArtifactArgs] = None,
              description: Optional[str] = None,
              base_image_version: Optional[str] = None,
              cpu_configurations: Optional[Sequence[ImageCpuConfigurationArgs]] = None,
              additional_os_capabilities: Optional[Sequence[str]] = None,
              egress_network_connectors: Optional[Sequence[str]] = None,
              environment_variables: Optional[Mapping[str, str]] = None,
              name: Optional[str] = None,
              region: Optional[str] = None,
              tags: Optional[Mapping[str, str]] = None,
              timeouts: Optional[ImageTimeoutsArgs] = None)
    func NewImage(ctx *Context, name string, args ImageArgs, opts ...ResourceOption) (*Image, error)
    public Image(string name, ImageArgs args, CustomResourceOptions? opts = null)
    public Image(String name, ImageArgs args)
    public Image(String name, ImageArgs args, CustomResourceOptions options)
    
    type: aws:lambdamicrovms:Image
    properties: # The arguments to resource properties.
    options: # Bag of options to control resource's behavior.
    
    
    resource "aws_lambdamicrovms_image" "name" {
        # resource properties
    }

    Parameters

    name string
    The unique name of the resource.
    args ImageArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resource.
    args ImageArgs
    The arguments to resource properties.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resource.
    args ImageArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args ImageArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args ImageArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Constructor example

    The following reference example uses placeholder values for all input properties.

    var awsImageResource = new Aws.LambdaMicroVMs.Image("awsImageResource", new()
    {
        BuildRoleArn = "string",
        BaseImageArn = "string",
        CodeArtifact = new Aws.LambdaMicroVMs.Inputs.ImageCodeArtifactArgs
        {
            Uri = "string",
        },
        Description = "string",
        BaseImageVersion = "string",
        CpuConfigurations = new[]
        {
            new Aws.LambdaMicroVMs.Inputs.ImageCpuConfigurationArgs
            {
                Architecture = "string",
            },
        },
        AdditionalOsCapabilities = new[]
        {
            "string",
        },
        EgressNetworkConnectors = new[]
        {
            "string",
        },
        EnvironmentVariables = 
        {
            { "string", "string" },
        },
        Name = "string",
        Region = "string",
        Tags = 
        {
            { "string", "string" },
        },
        Timeouts = new Aws.LambdaMicroVMs.Inputs.ImageTimeoutsArgs
        {
            Create = "string",
            Delete = "string",
            Update = "string",
        },
    });
    
    example, err := lambdamicrovms.NewImage(ctx, "awsImageResource", &lambdamicrovms.ImageArgs{
    	BuildRoleArn: pulumi.String("string"),
    	BaseImageArn: pulumi.String("string"),
    	CodeArtifact: &lambdamicrovms.ImageCodeArtifactArgs{
    		Uri: pulumi.String("string"),
    	},
    	Description:      pulumi.String("string"),
    	BaseImageVersion: pulumi.String("string"),
    	CpuConfigurations: lambdamicrovms.ImageCpuConfigurationArray{
    		&lambdamicrovms.ImageCpuConfigurationArgs{
    			Architecture: pulumi.String("string"),
    		},
    	},
    	AdditionalOsCapabilities: pulumi.StringArray{
    		pulumi.String("string"),
    	},
    	EgressNetworkConnectors: pulumi.StringArray{
    		pulumi.String("string"),
    	},
    	EnvironmentVariables: pulumi.StringMap{
    		"string": pulumi.String("string"),
    	},
    	Name:   pulumi.String("string"),
    	Region: pulumi.String("string"),
    	Tags: pulumi.StringMap{
    		"string": pulumi.String("string"),
    	},
    	Timeouts: &lambdamicrovms.ImageTimeoutsArgs{
    		Create: pulumi.String("string"),
    		Delete: pulumi.String("string"),
    		Update: pulumi.String("string"),
    	},
    })
    
    resource "aws_lambdamicrovms_image" "awsImageResource" {
      lifecycle {
        create_before_destroy = true
      }
      build_role_arn = "string"
      base_image_arn = "string"
      code_artifact = {
        uri = "string"
      }
      description        = "string"
      base_image_version = "string"
      cpu_configurations {
        architecture = "string"
      }
      additional_os_capabilities = ["string"]
      egress_network_connectors  = ["string"]
      environment_variables = {
        "string" = "string"
      }
      name   = "string"
      region = "string"
      tags = {
        "string" = "string"
      }
      timeouts = {
        create = "string"
        delete = "string"
        update = "string"
      }
    }
    
    var awsImageResource = new com.pulumi.aws.lambdamicrovms.Image("awsImageResource", com.pulumi.aws.lambdamicrovms.ImageArgs.builder()
        .buildRoleArn("string")
        .baseImageArn("string")
        .codeArtifact(ImageCodeArtifactArgs.builder()
            .uri("string")
            .build())
        .description("string")
        .baseImageVersion("string")
        .cpuConfigurations(ImageCpuConfigurationArgs.builder()
            .architecture("string")
            .build())
        .additionalOsCapabilities("string")
        .egressNetworkConnectors("string")
        .environmentVariables(Map.of("string", "string"))
        .name("string")
        .region("string")
        .tags(Map.of("string", "string"))
        .timeouts(ImageTimeoutsArgs.builder()
            .create("string")
            .delete("string")
            .update("string")
            .build())
        .build());
    
    aws_image_resource = aws.lambdamicrovms.Image("awsImageResource",
        build_role_arn="string",
        base_image_arn="string",
        code_artifact={
            "uri": "string",
        },
        description="string",
        base_image_version="string",
        cpu_configurations=[{
            "architecture": "string",
        }],
        additional_os_capabilities=["string"],
        egress_network_connectors=["string"],
        environment_variables={
            "string": "string",
        },
        name="string",
        region="string",
        tags={
            "string": "string",
        },
        timeouts={
            "create": "string",
            "delete": "string",
            "update": "string",
        })
    
    const awsImageResource = new aws.lambdamicrovms.Image("awsImageResource", {
        buildRoleArn: "string",
        baseImageArn: "string",
        codeArtifact: {
            uri: "string",
        },
        description: "string",
        baseImageVersion: "string",
        cpuConfigurations: [{
            architecture: "string",
        }],
        additionalOsCapabilities: ["string"],
        egressNetworkConnectors: ["string"],
        environmentVariables: {
            string: "string",
        },
        name: "string",
        region: "string",
        tags: {
            string: "string",
        },
        timeouts: {
            create: "string",
            "delete": "string",
            update: "string",
        },
    });
    
    type: aws:lambdamicrovms:Image
    properties:
        additionalOsCapabilities:
            - string
        baseImageArn: string
        baseImageVersion: string
        buildRoleArn: string
        codeArtifact:
            uri: string
        cpuConfigurations:
            - architecture: string
        description: string
        egressNetworkConnectors:
            - string
        environmentVariables:
            string: string
        name: string
        region: string
        tags:
            string: string
        timeouts:
            create: string
            delete: string
            update: string
    

    Image Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

    The Image resource accepts the following input properties:

    BaseImageArn string
    ARN of the base MicroVM image. AWS-managed base images use ARNs of the form arn:aws:lambda:<region>:aws:microvm-image:al2023-1.
    BuildRoleArn string
    ARN of the IAM role used to build the image. The role must be assumable by lambda.amazonaws.com and have access to the code artifact.
    CodeArtifact ImageCodeArtifact
    Code artifact containing the application code and metadata for the image. See below.
    AdditionalOsCapabilities List<string>
    List of additional OS capabilities granted to the MicroVM runtime environment. Valid values: ALL.
    BaseImageVersion string
    Major version number of the base MicroVM image to use (e.g., 1). If omitted, the service selects a version.
    CpuConfigurations List<ImageCpuConfiguration>
    CPU configuration for the MicroVM. See cpuConfiguration Block below.
    Description string
    Description of the MicroVM image.
    EgressNetworkConnectors List<string>
    List of egress network connectors available to the MicroVM at runtime. Defaults to ["INTERNET_EGRESS"].
    EnvironmentVariables Dictionary<string, string>
    Map of environment variables set in the MicroVM runtime environment.
    Name string

    Name of the MicroVM image. Changing this value creates a new resource.

    The following arguments are optional:

    Region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    Tags Dictionary<string, string>
    Map of tags assigned to the resource. If configured with a provider defaultTags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    Timeouts ImageTimeouts
    BaseImageArn string
    ARN of the base MicroVM image. AWS-managed base images use ARNs of the form arn:aws:lambda:<region>:aws:microvm-image:al2023-1.
    BuildRoleArn string
    ARN of the IAM role used to build the image. The role must be assumable by lambda.amazonaws.com and have access to the code artifact.
    CodeArtifact ImageCodeArtifactArgs
    Code artifact containing the application code and metadata for the image. See below.
    AdditionalOsCapabilities []string
    List of additional OS capabilities granted to the MicroVM runtime environment. Valid values: ALL.
    BaseImageVersion string
    Major version number of the base MicroVM image to use (e.g., 1). If omitted, the service selects a version.
    CpuConfigurations []ImageCpuConfigurationArgs
    CPU configuration for the MicroVM. See cpuConfiguration Block below.
    Description string
    Description of the MicroVM image.
    EgressNetworkConnectors []string
    List of egress network connectors available to the MicroVM at runtime. Defaults to ["INTERNET_EGRESS"].
    EnvironmentVariables map[string]string
    Map of environment variables set in the MicroVM runtime environment.
    Name string

    Name of the MicroVM image. Changing this value creates a new resource.

    The following arguments are optional:

    Region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    Tags map[string]string
    Map of tags assigned to the resource. If configured with a provider defaultTags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    Timeouts ImageTimeoutsArgs
    base_image_arn string
    ARN of the base MicroVM image. AWS-managed base images use ARNs of the form arn:aws:lambda:<region>:aws:microvm-image:al2023-1.
    build_role_arn string
    ARN of the IAM role used to build the image. The role must be assumable by lambda.amazonaws.com and have access to the code artifact.
    code_artifact object
    Code artifact containing the application code and metadata for the image. See below.
    additional_os_capabilities list(string)
    List of additional OS capabilities granted to the MicroVM runtime environment. Valid values: ALL.
    base_image_version string
    Major version number of the base MicroVM image to use (e.g., 1). If omitted, the service selects a version.
    cpu_configurations list(object)
    CPU configuration for the MicroVM. See cpuConfiguration Block below.
    description string
    Description of the MicroVM image.
    egress_network_connectors list(string)
    List of egress network connectors available to the MicroVM at runtime. Defaults to ["INTERNET_EGRESS"].
    environment_variables map(string)
    Map of environment variables set in the MicroVM runtime environment.
    name string

    Name of the MicroVM image. Changing this value creates a new resource.

    The following arguments are optional:

    region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    tags map(string)
    Map of tags assigned to the resource. If configured with a provider defaultTags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    timeouts object
    baseImageArn String
    ARN of the base MicroVM image. AWS-managed base images use ARNs of the form arn:aws:lambda:<region>:aws:microvm-image:al2023-1.
    buildRoleArn String
    ARN of the IAM role used to build the image. The role must be assumable by lambda.amazonaws.com and have access to the code artifact.
    codeArtifact ImageCodeArtifact
    Code artifact containing the application code and metadata for the image. See below.
    additionalOsCapabilities List<String>
    List of additional OS capabilities granted to the MicroVM runtime environment. Valid values: ALL.
    baseImageVersion String
    Major version number of the base MicroVM image to use (e.g., 1). If omitted, the service selects a version.
    cpuConfigurations List<ImageCpuConfiguration>
    CPU configuration for the MicroVM. See cpuConfiguration Block below.
    description String
    Description of the MicroVM image.
    egressNetworkConnectors List<String>
    List of egress network connectors available to the MicroVM at runtime. Defaults to ["INTERNET_EGRESS"].
    environmentVariables Map<String,String>
    Map of environment variables set in the MicroVM runtime environment.
    name String

    Name of the MicroVM image. Changing this value creates a new resource.

    The following arguments are optional:

    region String
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    tags Map<String,String>
    Map of tags assigned to the resource. If configured with a provider defaultTags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    timeouts ImageTimeouts
    baseImageArn string
    ARN of the base MicroVM image. AWS-managed base images use ARNs of the form arn:aws:lambda:<region>:aws:microvm-image:al2023-1.
    buildRoleArn string
    ARN of the IAM role used to build the image. The role must be assumable by lambda.amazonaws.com and have access to the code artifact.
    codeArtifact ImageCodeArtifact
    Code artifact containing the application code and metadata for the image. See below.
    additionalOsCapabilities string[]
    List of additional OS capabilities granted to the MicroVM runtime environment. Valid values: ALL.
    baseImageVersion string
    Major version number of the base MicroVM image to use (e.g., 1). If omitted, the service selects a version.
    cpuConfigurations ImageCpuConfiguration[]
    CPU configuration for the MicroVM. See cpuConfiguration Block below.
    description string
    Description of the MicroVM image.
    egressNetworkConnectors string[]
    List of egress network connectors available to the MicroVM at runtime. Defaults to ["INTERNET_EGRESS"].
    environmentVariables {[key: string]: string}
    Map of environment variables set in the MicroVM runtime environment.
    name string

    Name of the MicroVM image. Changing this value creates a new resource.

    The following arguments are optional:

    region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    tags {[key: string]: string}
    Map of tags assigned to the resource. If configured with a provider defaultTags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    timeouts ImageTimeouts
    base_image_arn str
    ARN of the base MicroVM image. AWS-managed base images use ARNs of the form arn:aws:lambda:<region>:aws:microvm-image:al2023-1.
    build_role_arn str
    ARN of the IAM role used to build the image. The role must be assumable by lambda.amazonaws.com and have access to the code artifact.
    code_artifact ImageCodeArtifactArgs
    Code artifact containing the application code and metadata for the image. See below.
    additional_os_capabilities Sequence[str]
    List of additional OS capabilities granted to the MicroVM runtime environment. Valid values: ALL.
    base_image_version str
    Major version number of the base MicroVM image to use (e.g., 1). If omitted, the service selects a version.
    cpu_configurations Sequence[ImageCpuConfigurationArgs]
    CPU configuration for the MicroVM. See cpuConfiguration Block below.
    description str
    Description of the MicroVM image.
    egress_network_connectors Sequence[str]
    List of egress network connectors available to the MicroVM at runtime. Defaults to ["INTERNET_EGRESS"].
    environment_variables Mapping[str, str]
    Map of environment variables set in the MicroVM runtime environment.
    name str

    Name of the MicroVM image. Changing this value creates a new resource.

    The following arguments are optional:

    region str
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    tags Mapping[str, str]
    Map of tags assigned to the resource. If configured with a provider defaultTags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    timeouts ImageTimeoutsArgs
    baseImageArn String
    ARN of the base MicroVM image. AWS-managed base images use ARNs of the form arn:aws:lambda:<region>:aws:microvm-image:al2023-1.
    buildRoleArn String
    ARN of the IAM role used to build the image. The role must be assumable by lambda.amazonaws.com and have access to the code artifact.
    codeArtifact Property Map
    Code artifact containing the application code and metadata for the image. See below.
    additionalOsCapabilities List<String>
    List of additional OS capabilities granted to the MicroVM runtime environment. Valid values: ALL.
    baseImageVersion String
    Major version number of the base MicroVM image to use (e.g., 1). If omitted, the service selects a version.
    cpuConfigurations List<Property Map>
    CPU configuration for the MicroVM. See cpuConfiguration Block below.
    description String
    Description of the MicroVM image.
    egressNetworkConnectors List<String>
    List of egress network connectors available to the MicroVM at runtime. Defaults to ["INTERNET_EGRESS"].
    environmentVariables Map<String>
    Map of environment variables set in the MicroVM runtime environment.
    name String

    Name of the MicroVM image. Changing this value creates a new resource.

    The following arguments are optional:

    region String
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    tags Map<String>
    Map of tags assigned to the resource. If configured with a provider defaultTags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    timeouts Property Map

    Outputs

    All input properties are implicitly available as output properties. Additionally, the Image resource produces the following output properties:

    Arn string
    ARN of the Image.
    CreatedAt string
    RFC3339 timestamp when the image was created.
    Id string
    The provider-assigned unique ID for this managed resource.
    ImageVersion string
    Current version of the image.
    LatestActiveImageVersion string
    Latest active version of the image.
    LatestFailedImageVersion string
    Latest failed version of the image, if any.
    State string
    Current state of the image (e.g., CREATED).
    TagsAll Dictionary<string, string>
    Map of tags assigned to the resource, including those inherited from the provider defaultTags configuration block.
    UpdatedAt string
    RFC3339 timestamp when the image was last updated.
    Arn string
    ARN of the Image.
    CreatedAt string
    RFC3339 timestamp when the image was created.
    Id string
    The provider-assigned unique ID for this managed resource.
    ImageVersion string
    Current version of the image.
    LatestActiveImageVersion string
    Latest active version of the image.
    LatestFailedImageVersion string
    Latest failed version of the image, if any.
    State string
    Current state of the image (e.g., CREATED).
    TagsAll map[string]string
    Map of tags assigned to the resource, including those inherited from the provider defaultTags configuration block.
    UpdatedAt string
    RFC3339 timestamp when the image was last updated.
    arn string
    ARN of the Image.
    created_at string
    RFC3339 timestamp when the image was created.
    id string
    The provider-assigned unique ID for this managed resource.
    image_version string
    Current version of the image.
    latest_active_image_version string
    Latest active version of the image.
    latest_failed_image_version string
    Latest failed version of the image, if any.
    state string
    Current state of the image (e.g., CREATED).
    tags_all map(string)
    Map of tags assigned to the resource, including those inherited from the provider defaultTags configuration block.
    updated_at string
    RFC3339 timestamp when the image was last updated.
    arn String
    ARN of the Image.
    createdAt String
    RFC3339 timestamp when the image was created.
    id String
    The provider-assigned unique ID for this managed resource.
    imageVersion String
    Current version of the image.
    latestActiveImageVersion String
    Latest active version of the image.
    latestFailedImageVersion String
    Latest failed version of the image, if any.
    state String
    Current state of the image (e.g., CREATED).
    tagsAll Map<String,String>
    Map of tags assigned to the resource, including those inherited from the provider defaultTags configuration block.
    updatedAt String
    RFC3339 timestamp when the image was last updated.
    arn string
    ARN of the Image.
    createdAt string
    RFC3339 timestamp when the image was created.
    id string
    The provider-assigned unique ID for this managed resource.
    imageVersion string
    Current version of the image.
    latestActiveImageVersion string
    Latest active version of the image.
    latestFailedImageVersion string
    Latest failed version of the image, if any.
    state string
    Current state of the image (e.g., CREATED).
    tagsAll {[key: string]: string}
    Map of tags assigned to the resource, including those inherited from the provider defaultTags configuration block.
    updatedAt string
    RFC3339 timestamp when the image was last updated.
    arn str
    ARN of the Image.
    created_at str
    RFC3339 timestamp when the image was created.
    id str
    The provider-assigned unique ID for this managed resource.
    image_version str
    Current version of the image.
    latest_active_image_version str
    Latest active version of the image.
    latest_failed_image_version str
    Latest failed version of the image, if any.
    state str
    Current state of the image (e.g., CREATED).
    tags_all Mapping[str, str]
    Map of tags assigned to the resource, including those inherited from the provider defaultTags configuration block.
    updated_at str
    RFC3339 timestamp when the image was last updated.
    arn String
    ARN of the Image.
    createdAt String
    RFC3339 timestamp when the image was created.
    id String
    The provider-assigned unique ID for this managed resource.
    imageVersion String
    Current version of the image.
    latestActiveImageVersion String
    Latest active version of the image.
    latestFailedImageVersion String
    Latest failed version of the image, if any.
    state String
    Current state of the image (e.g., CREATED).
    tagsAll Map<String>
    Map of tags assigned to the resource, including those inherited from the provider defaultTags configuration block.
    updatedAt String
    RFC3339 timestamp when the image was last updated.

    Look up Existing Image Resource

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

    public static get(name: string, id: Input<ID>, state?: ImageState, opts?: CustomResourceOptions): Image
    @staticmethod
    def get(resource_name: str,
            id: str,
            opts: Optional[ResourceOptions] = None,
            additional_os_capabilities: Optional[Sequence[str]] = None,
            arn: Optional[str] = None,
            base_image_arn: Optional[str] = None,
            base_image_version: Optional[str] = None,
            build_role_arn: Optional[str] = None,
            code_artifact: Optional[ImageCodeArtifactArgs] = None,
            cpu_configurations: Optional[Sequence[ImageCpuConfigurationArgs]] = None,
            created_at: Optional[str] = None,
            description: Optional[str] = None,
            egress_network_connectors: Optional[Sequence[str]] = None,
            environment_variables: Optional[Mapping[str, str]] = None,
            image_version: Optional[str] = None,
            latest_active_image_version: Optional[str] = None,
            latest_failed_image_version: Optional[str] = None,
            name: Optional[str] = None,
            region: Optional[str] = None,
            state: Optional[str] = None,
            tags: Optional[Mapping[str, str]] = None,
            tags_all: Optional[Mapping[str, str]] = None,
            timeouts: Optional[ImageTimeoutsArgs] = None,
            updated_at: Optional[str] = None) -> Image
    func GetImage(ctx *Context, name string, id IDInput, state *ImageState, opts ...ResourceOption) (*Image, error)
    public static Image Get(string name, Input<string> id, ImageState? state, CustomResourceOptions? opts = null)
    public static Image get(String name, Output<String> id, ImageState state, CustomResourceOptions options)
    resources:  _:    type: aws:lambdamicrovms:Image    get:      id: ${id}
    import {
      to = aws_lambdamicrovms_image.example
      id = "${id}"
    }
    
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    resource_name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    The following state arguments are supported:
    AdditionalOsCapabilities List<string>
    List of additional OS capabilities granted to the MicroVM runtime environment. Valid values: ALL.
    Arn string
    ARN of the Image.
    BaseImageArn string
    ARN of the base MicroVM image. AWS-managed base images use ARNs of the form arn:aws:lambda:<region>:aws:microvm-image:al2023-1.
    BaseImageVersion string
    Major version number of the base MicroVM image to use (e.g., 1). If omitted, the service selects a version.
    BuildRoleArn string
    ARN of the IAM role used to build the image. The role must be assumable by lambda.amazonaws.com and have access to the code artifact.
    CodeArtifact ImageCodeArtifact
    Code artifact containing the application code and metadata for the image. See below.
    CpuConfigurations List<ImageCpuConfiguration>
    CPU configuration for the MicroVM. See cpuConfiguration Block below.
    CreatedAt string
    RFC3339 timestamp when the image was created.
    Description string
    Description of the MicroVM image.
    EgressNetworkConnectors List<string>
    List of egress network connectors available to the MicroVM at runtime. Defaults to ["INTERNET_EGRESS"].
    EnvironmentVariables Dictionary<string, string>
    Map of environment variables set in the MicroVM runtime environment.
    ImageVersion string
    Current version of the image.
    LatestActiveImageVersion string
    Latest active version of the image.
    LatestFailedImageVersion string
    Latest failed version of the image, if any.
    Name string

    Name of the MicroVM image. Changing this value creates a new resource.

    The following arguments are optional:

    Region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    State string
    Current state of the image (e.g., CREATED).
    Tags Dictionary<string, string>
    Map of tags assigned to the resource. If configured with a provider defaultTags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    TagsAll Dictionary<string, string>
    Map of tags assigned to the resource, including those inherited from the provider defaultTags configuration block.
    Timeouts ImageTimeouts
    UpdatedAt string
    RFC3339 timestamp when the image was last updated.
    AdditionalOsCapabilities []string
    List of additional OS capabilities granted to the MicroVM runtime environment. Valid values: ALL.
    Arn string
    ARN of the Image.
    BaseImageArn string
    ARN of the base MicroVM image. AWS-managed base images use ARNs of the form arn:aws:lambda:<region>:aws:microvm-image:al2023-1.
    BaseImageVersion string
    Major version number of the base MicroVM image to use (e.g., 1). If omitted, the service selects a version.
    BuildRoleArn string
    ARN of the IAM role used to build the image. The role must be assumable by lambda.amazonaws.com and have access to the code artifact.
    CodeArtifact ImageCodeArtifactArgs
    Code artifact containing the application code and metadata for the image. See below.
    CpuConfigurations []ImageCpuConfigurationArgs
    CPU configuration for the MicroVM. See cpuConfiguration Block below.
    CreatedAt string
    RFC3339 timestamp when the image was created.
    Description string
    Description of the MicroVM image.
    EgressNetworkConnectors []string
    List of egress network connectors available to the MicroVM at runtime. Defaults to ["INTERNET_EGRESS"].
    EnvironmentVariables map[string]string
    Map of environment variables set in the MicroVM runtime environment.
    ImageVersion string
    Current version of the image.
    LatestActiveImageVersion string
    Latest active version of the image.
    LatestFailedImageVersion string
    Latest failed version of the image, if any.
    Name string

    Name of the MicroVM image. Changing this value creates a new resource.

    The following arguments are optional:

    Region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    State string
    Current state of the image (e.g., CREATED).
    Tags map[string]string
    Map of tags assigned to the resource. If configured with a provider defaultTags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    TagsAll map[string]string
    Map of tags assigned to the resource, including those inherited from the provider defaultTags configuration block.
    Timeouts ImageTimeoutsArgs
    UpdatedAt string
    RFC3339 timestamp when the image was last updated.
    additional_os_capabilities list(string)
    List of additional OS capabilities granted to the MicroVM runtime environment. Valid values: ALL.
    arn string
    ARN of the Image.
    base_image_arn string
    ARN of the base MicroVM image. AWS-managed base images use ARNs of the form arn:aws:lambda:<region>:aws:microvm-image:al2023-1.
    base_image_version string
    Major version number of the base MicroVM image to use (e.g., 1). If omitted, the service selects a version.
    build_role_arn string
    ARN of the IAM role used to build the image. The role must be assumable by lambda.amazonaws.com and have access to the code artifact.
    code_artifact object
    Code artifact containing the application code and metadata for the image. See below.
    cpu_configurations list(object)
    CPU configuration for the MicroVM. See cpuConfiguration Block below.
    created_at string
    RFC3339 timestamp when the image was created.
    description string
    Description of the MicroVM image.
    egress_network_connectors list(string)
    List of egress network connectors available to the MicroVM at runtime. Defaults to ["INTERNET_EGRESS"].
    environment_variables map(string)
    Map of environment variables set in the MicroVM runtime environment.
    image_version string
    Current version of the image.
    latest_active_image_version string
    Latest active version of the image.
    latest_failed_image_version string
    Latest failed version of the image, if any.
    name string

    Name of the MicroVM image. Changing this value creates a new resource.

    The following arguments are optional:

    region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    state string
    Current state of the image (e.g., CREATED).
    tags map(string)
    Map of tags assigned to the resource. If configured with a provider defaultTags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    tags_all map(string)
    Map of tags assigned to the resource, including those inherited from the provider defaultTags configuration block.
    timeouts object
    updated_at string
    RFC3339 timestamp when the image was last updated.
    additionalOsCapabilities List<String>
    List of additional OS capabilities granted to the MicroVM runtime environment. Valid values: ALL.
    arn String
    ARN of the Image.
    baseImageArn String
    ARN of the base MicroVM image. AWS-managed base images use ARNs of the form arn:aws:lambda:<region>:aws:microvm-image:al2023-1.
    baseImageVersion String
    Major version number of the base MicroVM image to use (e.g., 1). If omitted, the service selects a version.
    buildRoleArn String
    ARN of the IAM role used to build the image. The role must be assumable by lambda.amazonaws.com and have access to the code artifact.
    codeArtifact ImageCodeArtifact
    Code artifact containing the application code and metadata for the image. See below.
    cpuConfigurations List<ImageCpuConfiguration>
    CPU configuration for the MicroVM. See cpuConfiguration Block below.
    createdAt String
    RFC3339 timestamp when the image was created.
    description String
    Description of the MicroVM image.
    egressNetworkConnectors List<String>
    List of egress network connectors available to the MicroVM at runtime. Defaults to ["INTERNET_EGRESS"].
    environmentVariables Map<String,String>
    Map of environment variables set in the MicroVM runtime environment.
    imageVersion String
    Current version of the image.
    latestActiveImageVersion String
    Latest active version of the image.
    latestFailedImageVersion String
    Latest failed version of the image, if any.
    name String

    Name of the MicroVM image. Changing this value creates a new resource.

    The following arguments are optional:

    region String
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    state String
    Current state of the image (e.g., CREATED).
    tags Map<String,String>
    Map of tags assigned to the resource. If configured with a provider defaultTags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    tagsAll Map<String,String>
    Map of tags assigned to the resource, including those inherited from the provider defaultTags configuration block.
    timeouts ImageTimeouts
    updatedAt String
    RFC3339 timestamp when the image was last updated.
    additionalOsCapabilities string[]
    List of additional OS capabilities granted to the MicroVM runtime environment. Valid values: ALL.
    arn string
    ARN of the Image.
    baseImageArn string
    ARN of the base MicroVM image. AWS-managed base images use ARNs of the form arn:aws:lambda:<region>:aws:microvm-image:al2023-1.
    baseImageVersion string
    Major version number of the base MicroVM image to use (e.g., 1). If omitted, the service selects a version.
    buildRoleArn string
    ARN of the IAM role used to build the image. The role must be assumable by lambda.amazonaws.com and have access to the code artifact.
    codeArtifact ImageCodeArtifact
    Code artifact containing the application code and metadata for the image. See below.
    cpuConfigurations ImageCpuConfiguration[]
    CPU configuration for the MicroVM. See cpuConfiguration Block below.
    createdAt string
    RFC3339 timestamp when the image was created.
    description string
    Description of the MicroVM image.
    egressNetworkConnectors string[]
    List of egress network connectors available to the MicroVM at runtime. Defaults to ["INTERNET_EGRESS"].
    environmentVariables {[key: string]: string}
    Map of environment variables set in the MicroVM runtime environment.
    imageVersion string
    Current version of the image.
    latestActiveImageVersion string
    Latest active version of the image.
    latestFailedImageVersion string
    Latest failed version of the image, if any.
    name string

    Name of the MicroVM image. Changing this value creates a new resource.

    The following arguments are optional:

    region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    state string
    Current state of the image (e.g., CREATED).
    tags {[key: string]: string}
    Map of tags assigned to the resource. If configured with a provider defaultTags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    tagsAll {[key: string]: string}
    Map of tags assigned to the resource, including those inherited from the provider defaultTags configuration block.
    timeouts ImageTimeouts
    updatedAt string
    RFC3339 timestamp when the image was last updated.
    additional_os_capabilities Sequence[str]
    List of additional OS capabilities granted to the MicroVM runtime environment. Valid values: ALL.
    arn str
    ARN of the Image.
    base_image_arn str
    ARN of the base MicroVM image. AWS-managed base images use ARNs of the form arn:aws:lambda:<region>:aws:microvm-image:al2023-1.
    base_image_version str
    Major version number of the base MicroVM image to use (e.g., 1). If omitted, the service selects a version.
    build_role_arn str
    ARN of the IAM role used to build the image. The role must be assumable by lambda.amazonaws.com and have access to the code artifact.
    code_artifact ImageCodeArtifactArgs
    Code artifact containing the application code and metadata for the image. See below.
    cpu_configurations Sequence[ImageCpuConfigurationArgs]
    CPU configuration for the MicroVM. See cpuConfiguration Block below.
    created_at str
    RFC3339 timestamp when the image was created.
    description str
    Description of the MicroVM image.
    egress_network_connectors Sequence[str]
    List of egress network connectors available to the MicroVM at runtime. Defaults to ["INTERNET_EGRESS"].
    environment_variables Mapping[str, str]
    Map of environment variables set in the MicroVM runtime environment.
    image_version str
    Current version of the image.
    latest_active_image_version str
    Latest active version of the image.
    latest_failed_image_version str
    Latest failed version of the image, if any.
    name str

    Name of the MicroVM image. Changing this value creates a new resource.

    The following arguments are optional:

    region str
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    state str
    Current state of the image (e.g., CREATED).
    tags Mapping[str, str]
    Map of tags assigned to the resource. If configured with a provider defaultTags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    tags_all Mapping[str, str]
    Map of tags assigned to the resource, including those inherited from the provider defaultTags configuration block.
    timeouts ImageTimeoutsArgs
    updated_at str
    RFC3339 timestamp when the image was last updated.
    additionalOsCapabilities List<String>
    List of additional OS capabilities granted to the MicroVM runtime environment. Valid values: ALL.
    arn String
    ARN of the Image.
    baseImageArn String
    ARN of the base MicroVM image. AWS-managed base images use ARNs of the form arn:aws:lambda:<region>:aws:microvm-image:al2023-1.
    baseImageVersion String
    Major version number of the base MicroVM image to use (e.g., 1). If omitted, the service selects a version.
    buildRoleArn String
    ARN of the IAM role used to build the image. The role must be assumable by lambda.amazonaws.com and have access to the code artifact.
    codeArtifact Property Map
    Code artifact containing the application code and metadata for the image. See below.
    cpuConfigurations List<Property Map>
    CPU configuration for the MicroVM. See cpuConfiguration Block below.
    createdAt String
    RFC3339 timestamp when the image was created.
    description String
    Description of the MicroVM image.
    egressNetworkConnectors List<String>
    List of egress network connectors available to the MicroVM at runtime. Defaults to ["INTERNET_EGRESS"].
    environmentVariables Map<String>
    Map of environment variables set in the MicroVM runtime environment.
    imageVersion String
    Current version of the image.
    latestActiveImageVersion String
    Latest active version of the image.
    latestFailedImageVersion String
    Latest failed version of the image, if any.
    name String

    Name of the MicroVM image. Changing this value creates a new resource.

    The following arguments are optional:

    region String
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    state String
    Current state of the image (e.g., CREATED).
    tags Map<String>
    Map of tags assigned to the resource. If configured with a provider defaultTags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    tagsAll Map<String>
    Map of tags assigned to the resource, including those inherited from the provider defaultTags configuration block.
    timeouts Property Map
    updatedAt String
    RFC3339 timestamp when the image was last updated.

    Supporting Types

    ImageCodeArtifact, ImageCodeArtifactArgs

    Uri string
    S3 URI of the zip archive containing the application code and Dockerfile (e.g., s3://bucket/code.zip).
    Uri string
    S3 URI of the zip archive containing the application code and Dockerfile (e.g., s3://bucket/code.zip).
    uri string
    S3 URI of the zip archive containing the application code and Dockerfile (e.g., s3://bucket/code.zip).
    uri String
    S3 URI of the zip archive containing the application code and Dockerfile (e.g., s3://bucket/code.zip).
    uri string
    S3 URI of the zip archive containing the application code and Dockerfile (e.g., s3://bucket/code.zip).
    uri str
    S3 URI of the zip archive containing the application code and Dockerfile (e.g., s3://bucket/code.zip).
    uri String
    S3 URI of the zip archive containing the application code and Dockerfile (e.g., s3://bucket/code.zip).

    ImageCpuConfiguration, ImageCpuConfigurationArgs

    Architecture string
    CPU architecture for the MicroVM. Valid values are x8664 and arm64.
    Architecture string
    CPU architecture for the MicroVM. Valid values are x8664 and arm64.
    architecture string
    CPU architecture for the MicroVM. Valid values are x8664 and arm64.
    architecture String
    CPU architecture for the MicroVM. Valid values are x8664 and arm64.
    architecture string
    CPU architecture for the MicroVM. Valid values are x8664 and arm64.
    architecture str
    CPU architecture for the MicroVM. Valid values are x8664 and arm64.
    architecture String
    CPU architecture for the MicroVM. Valid values are x8664 and arm64.

    ImageTimeouts, ImageTimeoutsArgs

    Create string
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
    Delete string
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours). Setting a timeout for a Delete operation is only applicable if changes are saved into state before the destroy operation occurs.
    Update string
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
    Create string
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
    Delete string
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours). Setting a timeout for a Delete operation is only applicable if changes are saved into state before the destroy operation occurs.
    Update string
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
    create string
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
    delete string
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours). Setting a timeout for a Delete operation is only applicable if changes are saved into state before the destroy operation occurs.
    update string
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
    create String
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
    delete String
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours). Setting a timeout for a Delete operation is only applicable if changes are saved into state before the destroy operation occurs.
    update String
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
    create string
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
    delete string
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours). Setting a timeout for a Delete operation is only applicable if changes are saved into state before the destroy operation occurs.
    update string
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
    create str
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
    delete str
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours). Setting a timeout for a Delete operation is only applicable if changes are saved into state before the destroy operation occurs.
    update str
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
    create String
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
    delete String
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours). Setting a timeout for a Delete operation is only applicable if changes are saved into state before the destroy operation occurs.
    update String
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).

    Import

    Identity Schema

    Required

    • arn (String) ARN of the Lambda MicroVMs Image.

    Using pulumi import, import Lambda MicroVMs Image using the arn. For example:

    $ pulumi import aws:lambdamicrovms/image:Image example arn:aws:lambda:us-east-1:123456789012:microvm-image:example
    

    To learn more about importing existing cloud resources, see Importing resources.

    Package Details

    Repository
    AWS Classic pulumi/pulumi-aws
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the aws Terraform Provider.
    aws logo aws logo
    Viewing docs for AWS v7.46.0
    published on Thursday, Sep 10, 2026 by Pulumi

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial