published on Thursday, Sep 10, 2026 by Pulumi
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)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:
- Base
Image stringArn - 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 stringArn - ARN of the IAM role used to build the image. The role must be assumable by
lambda.amazonaws.comand have access to the code artifact. - Code
Artifact ImageCode Artifact - Code artifact containing the application code and metadata for the image. See below.
- Additional
Os List<string>Capabilities - List of additional OS capabilities granted to the MicroVM runtime environment. Valid values:
ALL. - Base
Image stringVersion - Major version number of the base MicroVM image to use (e.g.,
1). If omitted, the service selects a version. - Cpu
Configurations List<ImageCpu Configuration> - CPU configuration for the MicroVM. See
cpuConfigurationBlock below. - Description string
- Description of the MicroVM image.
- Egress
Network List<string>Connectors - List of egress network connectors available to the MicroVM at runtime. Defaults to
["INTERNET_EGRESS"]. - Environment
Variables 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.
- Dictionary<string, string>
- Map of tags assigned to the resource. If configured with a provider
defaultTagsconfiguration block present, tags with matching keys will overwrite those defined at the provider-level. - Timeouts
Image
Timeouts
- Base
Image stringArn - 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 stringArn - ARN of the IAM role used to build the image. The role must be assumable by
lambda.amazonaws.comand have access to the code artifact. - Code
Artifact ImageCode Artifact Args - Code artifact containing the application code and metadata for the image. See below.
- Additional
Os []stringCapabilities - List of additional OS capabilities granted to the MicroVM runtime environment. Valid values:
ALL. - Base
Image stringVersion - Major version number of the base MicroVM image to use (e.g.,
1). If omitted, the service selects a version. - Cpu
Configurations []ImageCpu Configuration Args - CPU configuration for the MicroVM. See
cpuConfigurationBlock below. - Description string
- Description of the MicroVM image.
- Egress
Network []stringConnectors - List of egress network connectors available to the MicroVM at runtime. Defaults to
["INTERNET_EGRESS"]. - Environment
Variables 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.
- map[string]string
- Map of tags assigned to the resource. If configured with a provider
defaultTagsconfiguration block present, tags with matching keys will overwrite those defined at the provider-level. - Timeouts
Image
Timeouts Args
- base_
image_ stringarn - 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_ stringarn - ARN of the IAM role used to build the image. The role must be assumable by
lambda.amazonaws.comand have access to the code artifact. - code_
artifact object - Code artifact containing the application code and metadata for the image. See below.
- additional_
os_ list(string)capabilities - List of additional OS capabilities granted to the MicroVM runtime environment. Valid values:
ALL. - base_
image_ stringversion - 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
cpuConfigurationBlock below. - description string
- Description of the MicroVM image.
- egress_
network_ list(string)connectors - 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.
- map(string)
- Map of tags assigned to the resource. If configured with a provider
defaultTagsconfiguration block present, tags with matching keys will overwrite those defined at the provider-level. - timeouts object
- base
Image StringArn - 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 StringArn - ARN of the IAM role used to build the image. The role must be assumable by
lambda.amazonaws.comand have access to the code artifact. - code
Artifact ImageCode Artifact - Code artifact containing the application code and metadata for the image. See below.
- additional
Os List<String>Capabilities - List of additional OS capabilities granted to the MicroVM runtime environment. Valid values:
ALL. - base
Image StringVersion - Major version number of the base MicroVM image to use (e.g.,
1). If omitted, the service selects a version. - cpu
Configurations List<ImageCpu Configuration> - CPU configuration for the MicroVM. See
cpuConfigurationBlock below. - description String
- Description of the MicroVM image.
- egress
Network List<String>Connectors - List of egress network connectors available to the MicroVM at runtime. Defaults to
["INTERNET_EGRESS"]. - environment
Variables 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.
- Map<String,String>
- Map of tags assigned to the resource. If configured with a provider
defaultTagsconfiguration block present, tags with matching keys will overwrite those defined at the provider-level. - timeouts
Image
Timeouts
- base
Image stringArn - 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 stringArn - ARN of the IAM role used to build the image. The role must be assumable by
lambda.amazonaws.comand have access to the code artifact. - code
Artifact ImageCode Artifact - Code artifact containing the application code and metadata for the image. See below.
- additional
Os string[]Capabilities - List of additional OS capabilities granted to the MicroVM runtime environment. Valid values:
ALL. - base
Image stringVersion - Major version number of the base MicroVM image to use (e.g.,
1). If omitted, the service selects a version. - cpu
Configurations ImageCpu Configuration[] - CPU configuration for the MicroVM. See
cpuConfigurationBlock below. - description string
- Description of the MicroVM image.
- egress
Network string[]Connectors - List of egress network connectors available to the MicroVM at runtime. Defaults to
["INTERNET_EGRESS"]. - environment
Variables {[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.
- {[key: string]: string}
- Map of tags assigned to the resource. If configured with a provider
defaultTagsconfiguration block present, tags with matching keys will overwrite those defined at the provider-level. - timeouts
Image
Timeouts
- base_
image_ strarn - 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_ strarn - ARN of the IAM role used to build the image. The role must be assumable by
lambda.amazonaws.comand have access to the code artifact. - code_
artifact ImageCode Artifact Args - Code artifact containing the application code and metadata for the image. See below.
- additional_
os_ Sequence[str]capabilities - List of additional OS capabilities granted to the MicroVM runtime environment. Valid values:
ALL. - base_
image_ strversion - Major version number of the base MicroVM image to use (e.g.,
1). If omitted, the service selects a version. - cpu_
configurations Sequence[ImageCpu Configuration Args] - CPU configuration for the MicroVM. See
cpuConfigurationBlock below. - description str
- Description of the MicroVM image.
- egress_
network_ Sequence[str]connectors - 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.
- Mapping[str, str]
- Map of tags assigned to the resource. If configured with a provider
defaultTagsconfiguration block present, tags with matching keys will overwrite those defined at the provider-level. - timeouts
Image
Timeouts Args
- base
Image StringArn - 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 StringArn - ARN of the IAM role used to build the image. The role must be assumable by
lambda.amazonaws.comand have access to the code artifact. - code
Artifact Property Map - Code artifact containing the application code and metadata for the image. See below.
- additional
Os List<String>Capabilities - List of additional OS capabilities granted to the MicroVM runtime environment. Valid values:
ALL. - base
Image StringVersion - Major version number of the base MicroVM image to use (e.g.,
1). If omitted, the service selects a version. - cpu
Configurations List<Property Map> - CPU configuration for the MicroVM. See
cpuConfigurationBlock below. - description String
- Description of the MicroVM image.
- egress
Network List<String>Connectors - 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.
- Map<String>
- Map of tags assigned to the resource. If configured with a provider
defaultTagsconfiguration 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.
- 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 stringImage Version - Latest active version of the image.
- Latest
Failed stringImage Version - Latest failed version of the image, if any.
- State string
- Current state of the image (e.g.,
CREATED). - Dictionary<string, string>
- Map of tags assigned to the resource, including those inherited from the provider
defaultTagsconfiguration block. - Updated
At 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 stringImage Version - Latest active version of the image.
- Latest
Failed stringImage Version - Latest failed version of the image, if any.
- State string
- Current state of the image (e.g.,
CREATED). - map[string]string
- Map of tags assigned to the resource, including those inherited from the provider
defaultTagsconfiguration block. - Updated
At 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_ stringimage_ version - Latest active version of the image.
- latest_
failed_ stringimage_ version - Latest failed version of the image, if any.
- state string
- Current state of the image (e.g.,
CREATED). - map(string)
- Map of tags assigned to the resource, including those inherited from the provider
defaultTagsconfiguration block. - updated_
at 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 StringImage Version - Latest active version of the image.
- latest
Failed StringImage Version - Latest failed version of the image, if any.
- state String
- Current state of the image (e.g.,
CREATED). - Map<String,String>
- Map of tags assigned to the resource, including those inherited from the provider
defaultTagsconfiguration block. - updated
At 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 stringImage Version - Latest active version of the image.
- latest
Failed stringImage Version - Latest failed version of the image, if any.
- state string
- Current state of the image (e.g.,
CREATED). - {[key: string]: string}
- Map of tags assigned to the resource, including those inherited from the provider
defaultTagsconfiguration block. - updated
At 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_ strimage_ version - Latest active version of the image.
- latest_
failed_ strimage_ version - Latest failed version of the image, if any.
- state str
- Current state of the image (e.g.,
CREATED). - Mapping[str, str]
- Map of tags assigned to the resource, including those inherited from the provider
defaultTagsconfiguration block. - updated_
at str - 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 StringImage Version - Latest active version of the image.
- latest
Failed StringImage Version - Latest failed version of the image, if any.
- state String
- Current state of the image (e.g.,
CREATED). - Map<String>
- Map of tags assigned to the resource, including those inherited from the provider
defaultTagsconfiguration block. - updated
At 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) -> Imagefunc 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.
- Additional
Os List<string>Capabilities - List of additional OS capabilities granted to the MicroVM runtime environment. Valid values:
ALL. - Arn string
- ARN of the Image.
- Base
Image stringArn - 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 stringVersion - Major version number of the base MicroVM image to use (e.g.,
1). If omitted, the service selects a version. - Build
Role stringArn - ARN of the IAM role used to build the image. The role must be assumable by
lambda.amazonaws.comand have access to the code artifact. - Code
Artifact ImageCode Artifact - Code artifact containing the application code and metadata for the image. See below.
- Cpu
Configurations List<ImageCpu Configuration> - CPU configuration for the MicroVM. See
cpuConfigurationBlock below. - Created
At string - RFC3339 timestamp when the image was created.
- Description string
- Description of the MicroVM image.
- Egress
Network List<string>Connectors - List of egress network connectors available to the MicroVM at runtime. Defaults to
["INTERNET_EGRESS"]. - Environment
Variables Dictionary<string, string> - Map of environment variables set in the MicroVM runtime environment.
- Image
Version string - Current version of the image.
- Latest
Active stringImage Version - Latest active version of the image.
- Latest
Failed stringImage Version - 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). - Dictionary<string, string>
- Map of tags assigned to the resource. If configured with a provider
defaultTagsconfiguration block present, tags with matching keys will overwrite those defined at the provider-level. - Dictionary<string, string>
- Map of tags assigned to the resource, including those inherited from the provider
defaultTagsconfiguration block. - Timeouts
Image
Timeouts - Updated
At string - RFC3339 timestamp when the image was last updated.
- Additional
Os []stringCapabilities - List of additional OS capabilities granted to the MicroVM runtime environment. Valid values:
ALL. - Arn string
- ARN of the Image.
- Base
Image stringArn - 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 stringVersion - Major version number of the base MicroVM image to use (e.g.,
1). If omitted, the service selects a version. - Build
Role stringArn - ARN of the IAM role used to build the image. The role must be assumable by
lambda.amazonaws.comand have access to the code artifact. - Code
Artifact ImageCode Artifact Args - Code artifact containing the application code and metadata for the image. See below.
- Cpu
Configurations []ImageCpu Configuration Args - CPU configuration for the MicroVM. See
cpuConfigurationBlock below. - Created
At string - RFC3339 timestamp when the image was created.
- Description string
- Description of the MicroVM image.
- Egress
Network []stringConnectors - List of egress network connectors available to the MicroVM at runtime. Defaults to
["INTERNET_EGRESS"]. - Environment
Variables map[string]string - Map of environment variables set in the MicroVM runtime environment.
- Image
Version string - Current version of the image.
- Latest
Active stringImage Version - Latest active version of the image.
- Latest
Failed stringImage Version - 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). - map[string]string
- Map of tags assigned to the resource. If configured with a provider
defaultTagsconfiguration block present, tags with matching keys will overwrite those defined at the provider-level. - map[string]string
- Map of tags assigned to the resource, including those inherited from the provider
defaultTagsconfiguration block. - Timeouts
Image
Timeouts Args - Updated
At string - RFC3339 timestamp when the image was last updated.
- additional_
os_ list(string)capabilities - List of additional OS capabilities granted to the MicroVM runtime environment. Valid values:
ALL. - arn string
- ARN of the Image.
- base_
image_ stringarn - 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_ stringversion - Major version number of the base MicroVM image to use (e.g.,
1). If omitted, the service selects a version. - build_
role_ stringarn - ARN of the IAM role used to build the image. The role must be assumable by
lambda.amazonaws.comand 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
cpuConfigurationBlock below. - created_
at string - RFC3339 timestamp when the image was created.
- description string
- Description of the MicroVM image.
- egress_
network_ list(string)connectors - 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_ stringimage_ version - Latest active version of the image.
- latest_
failed_ stringimage_ version - 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). - map(string)
- Map of tags assigned to the resource. If configured with a provider
defaultTagsconfiguration block present, tags with matching keys will overwrite those defined at the provider-level. - map(string)
- Map of tags assigned to the resource, including those inherited from the provider
defaultTagsconfiguration block. - timeouts object
- updated_
at string - RFC3339 timestamp when the image was last updated.
- additional
Os List<String>Capabilities - List of additional OS capabilities granted to the MicroVM runtime environment. Valid values:
ALL. - arn String
- ARN of the Image.
- base
Image StringArn - 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 StringVersion - Major version number of the base MicroVM image to use (e.g.,
1). If omitted, the service selects a version. - build
Role StringArn - ARN of the IAM role used to build the image. The role must be assumable by
lambda.amazonaws.comand have access to the code artifact. - code
Artifact ImageCode Artifact - Code artifact containing the application code and metadata for the image. See below.
- cpu
Configurations List<ImageCpu Configuration> - CPU configuration for the MicroVM. See
cpuConfigurationBlock below. - created
At String - RFC3339 timestamp when the image was created.
- description String
- Description of the MicroVM image.
- egress
Network List<String>Connectors - List of egress network connectors available to the MicroVM at runtime. Defaults to
["INTERNET_EGRESS"]. - environment
Variables Map<String,String> - Map of environment variables set in the MicroVM runtime environment.
- image
Version String - Current version of the image.
- latest
Active StringImage Version - Latest active version of the image.
- latest
Failed StringImage Version - 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). - Map<String,String>
- Map of tags assigned to the resource. If configured with a provider
defaultTagsconfiguration block present, tags with matching keys will overwrite those defined at the provider-level. - Map<String,String>
- Map of tags assigned to the resource, including those inherited from the provider
defaultTagsconfiguration block. - timeouts
Image
Timeouts - updated
At String - RFC3339 timestamp when the image was last updated.
- additional
Os string[]Capabilities - List of additional OS capabilities granted to the MicroVM runtime environment. Valid values:
ALL. - arn string
- ARN of the Image.
- base
Image stringArn - 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 stringVersion - Major version number of the base MicroVM image to use (e.g.,
1). If omitted, the service selects a version. - build
Role stringArn - ARN of the IAM role used to build the image. The role must be assumable by
lambda.amazonaws.comand have access to the code artifact. - code
Artifact ImageCode Artifact - Code artifact containing the application code and metadata for the image. See below.
- cpu
Configurations ImageCpu Configuration[] - CPU configuration for the MicroVM. See
cpuConfigurationBlock below. - created
At string - RFC3339 timestamp when the image was created.
- description string
- Description of the MicroVM image.
- egress
Network string[]Connectors - List of egress network connectors available to the MicroVM at runtime. Defaults to
["INTERNET_EGRESS"]. - environment
Variables {[key: string]: string} - Map of environment variables set in the MicroVM runtime environment.
- image
Version string - Current version of the image.
- latest
Active stringImage Version - Latest active version of the image.
- latest
Failed stringImage Version - 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). - {[key: string]: string}
- Map of tags assigned to the resource. If configured with a provider
defaultTagsconfiguration block present, tags with matching keys will overwrite those defined at the provider-level. - {[key: string]: string}
- Map of tags assigned to the resource, including those inherited from the provider
defaultTagsconfiguration block. - timeouts
Image
Timeouts - updated
At string - RFC3339 timestamp when the image was last updated.
- additional_
os_ Sequence[str]capabilities - List of additional OS capabilities granted to the MicroVM runtime environment. Valid values:
ALL. - arn str
- ARN of the Image.
- base_
image_ strarn - 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_ strversion - Major version number of the base MicroVM image to use (e.g.,
1). If omitted, the service selects a version. - build_
role_ strarn - ARN of the IAM role used to build the image. The role must be assumable by
lambda.amazonaws.comand have access to the code artifact. - code_
artifact ImageCode Artifact Args - Code artifact containing the application code and metadata for the image. See below.
- cpu_
configurations Sequence[ImageCpu Configuration Args] - CPU configuration for the MicroVM. See
cpuConfigurationBlock below. - created_
at str - RFC3339 timestamp when the image was created.
- description str
- Description of the MicroVM image.
- egress_
network_ Sequence[str]connectors - 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_ strimage_ version - Latest active version of the image.
- latest_
failed_ strimage_ version - 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). - Mapping[str, str]
- Map of tags assigned to the resource. If configured with a provider
defaultTagsconfiguration block present, tags with matching keys will overwrite those defined at the provider-level. - Mapping[str, str]
- Map of tags assigned to the resource, including those inherited from the provider
defaultTagsconfiguration block. - timeouts
Image
Timeouts Args - updated_
at str - RFC3339 timestamp when the image was last updated.
- additional
Os List<String>Capabilities - List of additional OS capabilities granted to the MicroVM runtime environment. Valid values:
ALL. - arn String
- ARN of the Image.
- base
Image StringArn - 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 StringVersion - Major version number of the base MicroVM image to use (e.g.,
1). If omitted, the service selects a version. - build
Role StringArn - ARN of the IAM role used to build the image. The role must be assumable by
lambda.amazonaws.comand have access to the code artifact. - code
Artifact Property Map - Code artifact containing the application code and metadata for the image. See below.
- cpu
Configurations List<Property Map> - CPU configuration for the MicroVM. See
cpuConfigurationBlock below. - created
At String - RFC3339 timestamp when the image was created.
- description String
- Description of the MicroVM image.
- egress
Network List<String>Connectors - 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 StringImage Version - Latest active version of the image.
- latest
Failed StringImage Version - 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). - Map<String>
- Map of tags assigned to the resource. If configured with a provider
defaultTagsconfiguration block present, tags with matching keys will overwrite those defined at the provider-level. - Map<String>
- Map of tags assigned to the resource, including those inherited from the provider
defaultTagsconfiguration block. - timeouts Property Map
- updated
At 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
x8664andarm64.
- Architecture string
- CPU architecture for the MicroVM. Valid values are
x8664andarm64.
- architecture string
- CPU architecture for the MicroVM. Valid values are
x8664andarm64.
- architecture String
- CPU architecture for the MicroVM. Valid values are
x8664andarm64.
- architecture string
- CPU architecture for the MicroVM. Valid values are
x8664andarm64.
- architecture str
- CPU architecture for the MicroVM. Valid values are
x8664andarm64.
- architecture String
- CPU architecture for the MicroVM. Valid values are
x8664andarm64.
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
awsTerraform Provider.
published on Thursday, Sep 10, 2026 by Pulumi