Runs a new MicroVM from the specified image. The MicroVM starts in PENDING state and transitions to RUNNING once provisioning completes. To connect, generate an authentication token using CreateMicrovmAuthToken.
Request body
The list of ingress network connectors to configure for the MicroVM.
The list of egress network connectors to configure for the MicroVM.
The ARN or ID of the MicroVmImage
The version of the MicroVM image to run.
The ARN of an IAM role that the service assumes to perform actions on behalf of the caller.
Per-MicroVM initialization data delivered as the request body of the /run lifecycle hook. Use to pass tenant-specific configuration such as session IDs or secret references. Maximum: 16,384 bytes.
The maximum duration in seconds that the MicroVM can exist before being terminated by the platform. Valid range: 1–28,800 (8 hours).
A unique, case-sensitive identifier you provide to ensure the idempotency of the request.
Response
Success
The unique identifier of the MicroVM.
The current lifecycle state of the MicroVM.
The HTTPS endpoint URL for communicating with the MicroVM. Include a valid authentication token in the X-aws-proxy-auth header when sending requests.
The ARN of the MicroVM image used to run this MicroVM.
The version of the MicroVM image used to run this MicroVM.
The ARN of the IAM execution role assumed by the MicroVM.
The maximum duration in seconds that the MicroVM can exist.
The timestamp when the MicroVM first started.
The timestamp when the MicroVM terminated.
The reason for why the MicroVM is in the current state.
The list of ingress network connectors configured for the MicroVM.
The list of egress network connectors configured for the MicroVM.