Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1424154118.9 KB

Retrieves the details of a specific MicroVM, including its state, endpoint, image information, and configuration. The state field is eventually consistent — determine readiness by connecting to the endpoint.

get/2025-09-09/microvms/{microvmIdentifier}

Path parameters

microvmIdentifierstring required

The ARN or ID of the MicroVm

The ID of the MicroVM to retrieve.

Response

Success

microvmIdstring required

The unique identifier of the MicroVM.

state'PENDING' | 'RUNNING' | 'SUSPENDING' | 'SUSPENDED' | 'TERMINATING' | 'TERMINATED' required

The current lifecycle state of the MicroVM.

endpointstring required

The HTTPS endpoint URL for communicating with the MicroVM. Include a valid authentication token in the X-aws-proxy-auth header when sending requests.

imageArnstring required

The ARN of the MicroVM image used to run this MicroVM.

imageVersionstring required

The version of the MicroVM image used to run this MicroVM.

executionRoleArnstring

The ARN of the IAM execution role assumed by the MicroVM.

maximumDurationInSecondsinteger required

The maximum duration in seconds that the MicroVM can exist before being terminated by the platform.

startedAtstring date-time required

The timestamp when the MicroVM first started.

terminatedAtstring date-time

The timestamp when the MicroVM terminated.

stateReasonstring

The reason for why the MicroVM is in the current state.

ingressNetworkConnectorsNetworkConnector[]

The list of ingress network connectors configured for the MicroVM.

egressNetworkConnectorsNetworkConnector[]

The list of egress network connectors configured for the MicroVM.