1. Packages
  2. Packages
  3. AWS Cloud Control
  4. API Docs
  5. lambda
  6. MicrovmImage

We recommend new projects start with resources from the AWS provider.

Viewing docs for AWS Cloud Control v1.73.0
published on Monday, Jul 27, 2026 by Pulumi
aws-native logo

We recommend new projects start with resources from the AWS provider.

Viewing docs for AWS Cloud Control v1.73.0
published on Monday, Jul 27, 2026 by Pulumi

    Resource Type definition for AWS::Lambda::MicrovmImage

    Create MicrovmImage Resource

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

    Constructor syntax

    new MicrovmImage(name: string, args: MicrovmImageArgs, opts?: CustomResourceOptions);
    @overload
    def MicrovmImage(resource_name: str,
                     args: MicrovmImageArgs,
                     opts: Optional[ResourceOptions] = None)
    
    @overload
    def MicrovmImage(resource_name: str,
                     opts: Optional[ResourceOptions] = None,
                     description: Optional[str] = None,
                     resources: Optional[Sequence[MicrovmImageResourcesArgs]] = None,
                     base_image_version: Optional[str] = None,
                     build_role_arn: Optional[str] = None,
                     code_artifact: Optional[MicrovmImageCodeArtifactArgs] = None,
                     cpu_configurations: Optional[Sequence[MicrovmImageCpuConfigurationArgs]] = None,
                     environment_variables: Optional[Sequence[MicrovmImageEnvironmentVariableArgs]] = None,
                     additional_os_capabilities: Optional[Sequence[MicrovmImageAdditionalOsCapabilitiesItem]] = None,
                     base_image_arn: Optional[str] = None,
                     hooks: Optional[HooksArgs] = None,
                     logging: Optional[MicrovmImageLoggingArgs] = None,
                     egress_network_connectors: Optional[Sequence[str]] = None,
                     name: Optional[str] = None,
                     tags: Optional[Sequence[_root_inputs.TagArgs]] = None)
    func NewMicrovmImage(ctx *Context, name string, args MicrovmImageArgs, opts ...ResourceOption) (*MicrovmImage, error)
    public MicrovmImage(string name, MicrovmImageArgs args, CustomResourceOptions? opts = null)
    public MicrovmImage(String name, MicrovmImageArgs args)
    public MicrovmImage(String name, MicrovmImageArgs args, CustomResourceOptions options)
    
    type: aws-native:lambda:MicrovmImage
    properties: # The arguments to resource properties.
    options: # Bag of options to control resource's behavior.
    
    
    resource "aws-native_lambda_microvm_image" "name" {
        # resource properties
    }

    Parameters

    name string
    The unique name of the resource.
    args MicrovmImageArgs
    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 MicrovmImageArgs
    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 MicrovmImageArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args MicrovmImageArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args MicrovmImageArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    MicrovmImage 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 MicrovmImage resource accepts the following input properties:

    AdditionalOsCapabilities List<Pulumi.AwsNative.Lambda.MicrovmImageAdditionalOsCapabilitiesItem>
    BaseImageArn string
    ARN of the base MicroVM image.
    BaseImageVersion string
    Specific version of the base MicroVM image to use.
    BuildRoleArn string
    ARN of the IAM build role.
    CodeArtifact Pulumi.AwsNative.Lambda.Inputs.MicrovmImageCodeArtifact
    Code artifact for the active MicroVM image.
    CpuConfigurations List<Pulumi.AwsNative.Lambda.Inputs.MicrovmImageCpuConfiguration>
    Description string
    Human-readable description of the MicroVM image and its purpose.
    EgressNetworkConnectors List<string>
    EnvironmentVariables List<Pulumi.AwsNative.Lambda.Inputs.MicrovmImageEnvironmentVariable>
    Environment variables to set in the container during the snapshot build.
    Hooks Pulumi.AwsNative.Lambda.Inputs.Hooks
    Logging Pulumi.AwsNative.Lambda.Inputs.MicrovmImageLogging
    Configuration for MicroVM image logging.
    Resources List<Pulumi.AwsNative.Lambda.Inputs.MicrovmImageResources>
    Name string
    Unique name for the MicroVM image within the account.
    Tags List<Pulumi.AwsNative.Inputs.Tag>
    Key-value pairs to associate with the MicroVM image for organization and management.
    AdditionalOsCapabilities []MicrovmImageAdditionalOsCapabilitiesItem
    BaseImageArn string
    ARN of the base MicroVM image.
    BaseImageVersion string
    Specific version of the base MicroVM image to use.
    BuildRoleArn string
    ARN of the IAM build role.
    CodeArtifact MicrovmImageCodeArtifactArgs
    Code artifact for the active MicroVM image.
    CpuConfigurations []MicrovmImageCpuConfigurationArgs
    Description string
    Human-readable description of the MicroVM image and its purpose.
    EgressNetworkConnectors []string
    EnvironmentVariables []MicrovmImageEnvironmentVariableArgs
    Environment variables to set in the container during the snapshot build.
    Hooks HooksArgs
    Logging MicrovmImageLoggingArgs
    Configuration for MicroVM image logging.
    Resources []MicrovmImageResourcesArgs
    Name string
    Unique name for the MicroVM image within the account.
    Tags TagArgs
    Key-value pairs to associate with the MicroVM image for organization and management.
    additional_os_capabilities list("ALL")
    base_image_arn string
    ARN of the base MicroVM image.
    base_image_version string
    Specific version of the base MicroVM image to use.
    build_role_arn string
    ARN of the IAM build role.
    code_artifact object
    Code artifact for the active MicroVM image.
    cpu_configurations list(object)
    description string
    Human-readable description of the MicroVM image and its purpose.
    egress_network_connectors list(string)
    environment_variables list(object)
    Environment variables to set in the container during the snapshot build.
    hooks object
    logging object
    Configuration for MicroVM image logging.
    resources list(object)
    name string
    Unique name for the MicroVM image within the account.
    tags list(object)
    Key-value pairs to associate with the MicroVM image for organization and management.
    additionalOsCapabilities List<MicrovmImageAdditionalOsCapabilitiesItem>
    baseImageArn String
    ARN of the base MicroVM image.
    baseImageVersion String
    Specific version of the base MicroVM image to use.
    buildRoleArn String
    ARN of the IAM build role.
    codeArtifact MicrovmImageCodeArtifact
    Code artifact for the active MicroVM image.
    cpuConfigurations List<MicrovmImageCpuConfiguration>
    description String
    Human-readable description of the MicroVM image and its purpose.
    egressNetworkConnectors List<String>
    environmentVariables List<MicrovmImageEnvironmentVariable>
    Environment variables to set in the container during the snapshot build.
    hooks Hooks
    logging MicrovmImageLogging
    Configuration for MicroVM image logging.
    resources List<MicrovmImageResources>
    name String
    Unique name for the MicroVM image within the account.
    tags List<Tag>
    Key-value pairs to associate with the MicroVM image for organization and management.
    additionalOsCapabilities MicrovmImageAdditionalOsCapabilitiesItem[]
    baseImageArn string
    ARN of the base MicroVM image.
    baseImageVersion string
    Specific version of the base MicroVM image to use.
    buildRoleArn string
    ARN of the IAM build role.
    codeArtifact MicrovmImageCodeArtifact
    Code artifact for the active MicroVM image.
    cpuConfigurations MicrovmImageCpuConfiguration[]
    description string
    Human-readable description of the MicroVM image and its purpose.
    egressNetworkConnectors string[]
    environmentVariables MicrovmImageEnvironmentVariable[]
    Environment variables to set in the container during the snapshot build.
    hooks Hooks
    logging MicrovmImageLogging
    Configuration for MicroVM image logging.
    resources MicrovmImageResources[]
    name string
    Unique name for the MicroVM image within the account.
    tags Tag[]
    Key-value pairs to associate with the MicroVM image for organization and management.
    additional_os_capabilities Sequence[MicrovmImageAdditionalOsCapabilitiesItem]
    base_image_arn str
    ARN of the base MicroVM image.
    base_image_version str
    Specific version of the base MicroVM image to use.
    build_role_arn str
    ARN of the IAM build role.
    code_artifact MicrovmImageCodeArtifactArgs
    Code artifact for the active MicroVM image.
    cpu_configurations Sequence[MicrovmImageCpuConfigurationArgs]
    description str
    Human-readable description of the MicroVM image and its purpose.
    egress_network_connectors Sequence[str]
    environment_variables Sequence[MicrovmImageEnvironmentVariableArgs]
    Environment variables to set in the container during the snapshot build.
    hooks HooksArgs
    logging MicrovmImageLoggingArgs
    Configuration for MicroVM image logging.
    resources Sequence[MicrovmImageResourcesArgs]
    name str
    Unique name for the MicroVM image within the account.
    tags Sequence[TagArgs]
    Key-value pairs to associate with the MicroVM image for organization and management.
    additionalOsCapabilities List<"ALL">
    baseImageArn String
    ARN of the base MicroVM image.
    baseImageVersion String
    Specific version of the base MicroVM image to use.
    buildRoleArn String
    ARN of the IAM build role.
    codeArtifact Property Map
    Code artifact for the active MicroVM image.
    cpuConfigurations List<Property Map>
    description String
    Human-readable description of the MicroVM image and its purpose.
    egressNetworkConnectors List<String>
    environmentVariables List<Property Map>
    Environment variables to set in the container during the snapshot build.
    hooks Property Map
    logging Property Map
    Configuration for MicroVM image logging.
    resources List<Property Map>
    name String
    Unique name for the MicroVM image within the account.
    tags List<Property Map>
    Key-value pairs to associate with the MicroVM image for organization and management.

    Outputs

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

    CreatedAt string
    Timestamp when the MicroVM image was created.
    Id string
    The provider-assigned unique ID for this managed resource.
    ImageArn string
    ARN of the MicroVM image.
    LatestActiveImageVersion string
    The latest active version of the MicroVM image.
    LatestFailedImageVersion string
    The latest failed version of the MicroVM image.
    State Pulumi.AwsNative.Lambda.MicrovmImageState
    Current state of the MicroVM image.
    UpdatedAt string
    Timestamp when the MicroVM image was updated.
    CreatedAt string
    Timestamp when the MicroVM image was created.
    Id string
    The provider-assigned unique ID for this managed resource.
    ImageArn string
    ARN of the MicroVM image.
    LatestActiveImageVersion string
    The latest active version of the MicroVM image.
    LatestFailedImageVersion string
    The latest failed version of the MicroVM image.
    State MicrovmImageStateEnum
    Current state of the MicroVM image.
    UpdatedAt string
    Timestamp when the MicroVM image was updated.
    created_at string
    Timestamp when the MicroVM image was created.
    id string
    The provider-assigned unique ID for this managed resource.
    image_arn string
    ARN of the MicroVM image.
    latest_active_image_version string
    The latest active version of the MicroVM image.
    latest_failed_image_version string
    The latest failed version of the MicroVM image.
    state "CREATING" | "CREATED" | "CREATE_FAILED" | "UPDATING" | "UPDATED" | "UPDATE_FAILED" | "DELETING" | "DELETE_FAILED" | "DELETED"
    Current state of the MicroVM image.
    updated_at string
    Timestamp when the MicroVM image was updated.
    createdAt String
    Timestamp when the MicroVM image was created.
    id String
    The provider-assigned unique ID for this managed resource.
    imageArn String
    ARN of the MicroVM image.
    latestActiveImageVersion String
    The latest active version of the MicroVM image.
    latestFailedImageVersion String
    The latest failed version of the MicroVM image.
    state MicrovmImageState
    Current state of the MicroVM image.
    updatedAt String
    Timestamp when the MicroVM image was updated.
    createdAt string
    Timestamp when the MicroVM image was created.
    id string
    The provider-assigned unique ID for this managed resource.
    imageArn string
    ARN of the MicroVM image.
    latestActiveImageVersion string
    The latest active version of the MicroVM image.
    latestFailedImageVersion string
    The latest failed version of the MicroVM image.
    state MicrovmImageState
    Current state of the MicroVM image.
    updatedAt string
    Timestamp when the MicroVM image was updated.
    created_at str
    Timestamp when the MicroVM image was created.
    id str
    The provider-assigned unique ID for this managed resource.
    image_arn str
    ARN of the MicroVM image.
    latest_active_image_version str
    The latest active version of the MicroVM image.
    latest_failed_image_version str
    The latest failed version of the MicroVM image.
    state MicrovmImageState
    Current state of the MicroVM image.
    updated_at str
    Timestamp when the MicroVM image was updated.
    createdAt String
    Timestamp when the MicroVM image was created.
    id String
    The provider-assigned unique ID for this managed resource.
    imageArn String
    ARN of the MicroVM image.
    latestActiveImageVersion String
    The latest active version of the MicroVM image.
    latestFailedImageVersion String
    The latest failed version of the MicroVM image.
    state "CREATING" | "CREATED" | "CREATE_FAILED" | "UPDATING" | "UPDATED" | "UPDATE_FAILED" | "DELETING" | "DELETE_FAILED" | "DELETED"
    Current state of the MicroVM image.
    updatedAt String
    Timestamp when the MicroVM image was updated.

    Supporting Types

    Hooks, HooksArgs

    MicrovmImageAdditionalOsCapabilitiesItem, MicrovmImageAdditionalOsCapabilitiesItemArgs

    All
    ALL
    MicrovmImageAdditionalOsCapabilitiesItemAll
    ALL
    "ALL"
    ALL
    All
    ALL
    All
    ALL
    ALL
    ALL
    "ALL"
    ALL

    MicrovmImageCloudWatchLogging, MicrovmImageCloudWatchLoggingArgs

    LogGroup string
    LogStream string
    LogGroup string
    LogStream string
    log_group string
    log_stream string
    logGroup String
    logStream String
    logGroup string
    logStream string
    logGroup String
    logStream String

    MicrovmImageCodeArtifact, MicrovmImageCodeArtifactArgs

    Uri string
    Uri string
    uri string
    uri String
    uri string
    uri str
    uri String

    MicrovmImageCpuConfiguration, MicrovmImageCpuConfigurationArgs

    MicrovmImageCpuConfigurationArchitecture, MicrovmImageCpuConfigurationArchitectureArgs

    Arm64
    ARM_64
    MicrovmImageCpuConfigurationArchitectureArm64
    ARM_64
    "ARM_64"
    ARM_64
    Arm64
    ARM_64
    Arm64
    ARM_64
    ARM64
    ARM_64
    "ARM_64"
    ARM_64

    MicrovmImageEnvironmentVariable, MicrovmImageEnvironmentVariableArgs

    Key string
    Value string
    Key string
    Value string
    key string
    value string
    key String
    value String
    key string
    value string
    key str
    value str
    key String
    value String

    MicrovmImageHookState, MicrovmImageHookStateArgs

    Disabled
    DISABLED
    Enabled
    ENABLED
    MicrovmImageHookStateDisabled
    DISABLED
    MicrovmImageHookStateEnabled
    ENABLED
    "DISABLED"
    DISABLED
    "ENABLED"
    ENABLED
    Disabled
    DISABLED
    Enabled
    ENABLED
    Disabled
    DISABLED
    Enabled
    ENABLED
    DISABLED
    DISABLED
    ENABLED
    ENABLED
    "DISABLED"
    DISABLED
    "ENABLED"
    ENABLED

    MicrovmImageHooks, MicrovmImageHooksArgs

    MicrovmImageLogging, MicrovmImageLoggingArgs

    MicrovmImageMicrovmHooks, MicrovmImageMicrovmHooksArgs

    MicrovmImageResources, MicrovmImageResourcesArgs

    MicrovmImageState, MicrovmImageStateArgs

    Creating
    CREATING
    Created
    CREATED
    CreateFailed
    CREATE_FAILED
    Updating
    UPDATING
    Updated
    UPDATED
    UpdateFailed
    UPDATE_FAILED
    Deleting
    DELETING
    DeleteFailed
    DELETE_FAILED
    Deleted
    DELETED
    MicrovmImageStateCreating
    CREATING
    MicrovmImageStateCreated
    CREATED
    MicrovmImageStateCreateFailed
    CREATE_FAILED
    MicrovmImageStateUpdating
    UPDATING
    MicrovmImageStateUpdated
    UPDATED
    MicrovmImageStateUpdateFailed
    UPDATE_FAILED
    MicrovmImageStateDeleting
    DELETING
    MicrovmImageStateDeleteFailed
    DELETE_FAILED
    MicrovmImageStateDeleted
    DELETED
    "CREATING"
    CREATING
    "CREATED"
    CREATED
    "CREATE_FAILED"
    CREATE_FAILED
    "UPDATING"
    UPDATING
    "UPDATED"
    UPDATED
    "UPDATE_FAILED"
    UPDATE_FAILED
    "DELETING"
    DELETING
    "DELETE_FAILED"
    DELETE_FAILED
    "DELETED"
    DELETED
    Creating
    CREATING
    Created
    CREATED
    CreateFailed
    CREATE_FAILED
    Updating
    UPDATING
    Updated
    UPDATED
    UpdateFailed
    UPDATE_FAILED
    Deleting
    DELETING
    DeleteFailed
    DELETE_FAILED
    Deleted
    DELETED
    Creating
    CREATING
    Created
    CREATED
    CreateFailed
    CREATE_FAILED
    Updating
    UPDATING
    Updated
    UPDATED
    UpdateFailed
    UPDATE_FAILED
    Deleting
    DELETING
    DeleteFailed
    DELETE_FAILED
    Deleted
    DELETED
    CREATING
    CREATING
    CREATED
    CREATED
    CREATE_FAILED
    CREATE_FAILED
    UPDATING
    UPDATING
    UPDATED
    UPDATED
    UPDATE_FAILED
    UPDATE_FAILED
    DELETING
    DELETING
    DELETE_FAILED
    DELETE_FAILED
    DELETED
    DELETED
    "CREATING"
    CREATING
    "CREATED"
    CREATED
    "CREATE_FAILED"
    CREATE_FAILED
    "UPDATING"
    UPDATING
    "UPDATED"
    UPDATED
    "UPDATE_FAILED"
    UPDATE_FAILED
    "DELETING"
    DELETING
    "DELETE_FAILED"
    DELETE_FAILED
    "DELETED"
    DELETED

    Tag, TagArgs

    A set of tags to apply to the resource.
    Key string
    The key name of the tag
    Value string
    The value of the tag
    Key string
    The key name of the tag
    Value string
    The value of the tag
    key string
    The key name of the tag
    value string
    The value of the tag
    key String
    The key name of the tag
    value String
    The value of the tag
    key string
    The key name of the tag
    value string
    The value of the tag
    key str
    The key name of the tag
    value str
    The value of the tag
    key String
    The key name of the tag
    value String
    The value of the tag

    Package Details

    Repository
    AWS Native pulumi/pulumi-aws-native
    License
    Apache-2.0
    aws-native logo

    We recommend new projects start with resources from the AWS provider.

    Viewing docs for AWS Cloud Control v1.73.0
    published on Monday, Jul 27, 2026 by Pulumi

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial