---
title: "GET /2025-09-09/microvms/{microvmIdentifier}"
method: GET
path: "/2025-09-09/microvms/{microvmIdentifier}"
---

# GET /2025-09-09/microvms/{microvmIdentifier}

`GET /2025-09-09/microvms/{microvmIdentifier}`

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.

## Path parameters

- `microvmIdentifier` string, required — The ARN or ID of the MicroVm

## Response `200`

Success

- GetMicrovmResponse
  - `microvmId` string, required — The unique identifier of the MicroVM.
  - `state` 'PENDING' | 'RUNNING' | 'SUSPENDING' | 'SUSPENDED' | 'TERMINATING' | 'TERMINATED', required — The current lifecycle state of the MicroVM.
  - `endpoint` string, 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.
  - `imageArn` string, required — The ARN of the MicroVM image used to run this MicroVM.
  - `imageVersion` string, required — The version of the MicroVM image used to run this MicroVM.
  - `executionRoleArn` string — The ARN of the IAM execution role assumed by the MicroVM.
  - `idlePolicy` object — The idle policy configuration of the MicroVM, controlling auto-suspend and auto-resume behavior.
    - `maxIdleDurationSeconds` integer, required — The maximum time in seconds that a MicroVM can remain idle before it is automatically suspended.
    - `suspendedDurationSeconds` integer, required — The maximum time in seconds that a MicroVM can remain suspended before it is automatically terminated.
    - `autoResumeEnabled` boolean, required — Indicates whether the MicroVM automatically resumes when it receives a request while suspended.
  - `maximumDurationInSeconds` integer, required — The maximum duration in seconds that the MicroVM can exist before being terminated by the platform.
  - `startedAt` string, date-time, required — The timestamp when the MicroVM first started.
  - `terminatedAt` string, date-time — The timestamp when the MicroVM terminated.
  - `stateReason` string — The reason for why the MicroVM is in the current state.
  - `ingressNetworkConnectors` NetworkConnector[] — The list of ingress network connectors configured for the MicroVM.
  - `egressNetworkConnectors` NetworkConnector[] — The list of egress network connectors configured for the MicroVM.

## Other responses

- `480` — InternalServerException
- `481` — AccessDeniedException
- `482` — ResourceNotFoundException
- `483` — ThrottlingException
- `484` — ValidationException

---

[API](https://skmtc.net/aws/apis/lambda-microvms.md) · [All operations](https://skmtc.net/aws/apis/lambda-microvms/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/lambda-microvms/versions/83f10af82eb8/schema)