Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1424154118.9 KB

Retrieves the details of a specific version of a MicroVM image, including its configuration, state, and build information.

get/2025-09-09/microvm-images/{imageIdentifier}/versions/{imageVersion}

Path parameters

imageIdentifierstring required

The ARN or ID of the MicroVmImage

The unique identifier (ARN or ID) of the MicroVM image.

imageVersionstring required

A string which is not empty or blank (only whitespace).

The version of the MicroVM image to retrieve.

Response

Success

baseImageArnstring required

The ARN of the base MicroVM image used.

baseImageVersionstring

The specific version of the base MicroVM image.

buildRoleArnstring required

The ARN of the IAM build role.

descriptionstring

The description of the version.

egressNetworkConnectorsNetworkConnector[]

The list of egress network connectors available to the MicroVM at runtime.

additionalOsCapabilitiesCapability[]

Additional OS capabilities granted to the MicroVM runtime environment.

environmentVariablesobject

Environment variables set in the MicroVM runtime environment.

imageArnstring required

The ARN of the MicroVM image.

imageVersionstring required

The version of the MicroVM image.

state'PENDING' | 'IN_PROGRESS' | 'SUCCESSFUL' | 'FAILED' | 'DELETING' | 'DELETED' | 'DELETE_FAILED' required

The current state of the version.

status'ACTIVE' | 'INACTIVE' required

The availability status of the version: ACTIVE (can be used by RunMicrovm) or INACTIVE (blocked from launching new MicroVMs).

createdAtstring date-time required

The timestamp when the version was created.

updatedAtstring date-time

The timestamp when the version was last updated.

stateReasonstring

The reason for the current state. For example, one or more builds failed.

tagsobject

Key-value pairs associated with the version.