Launch from a machine image

Launch a new instance as a copy of the disk one of your machine images was taken from.

Last updated 18 November 2026View as Markdown

The new instance boots from a copy of the disk the image was taken from: everything that was on that disk is on the new one. Replace the ids with your own.

Prerequisites

  • Permission for ec2:RunInstances. In the console, listing your images also needs ec2:DescribeImages.
  • An available image of yours in the region you launch in.
  • An instance type of the image's architecture with a disk at least as big as the one the image was taken from.

Launch

  1. Open Compute, then Images, and choose an image whose state is available to open its details.
  2. Choose Launch instance from this image. The Create instance form opens with the image chosen.
  3. Fill in the rest (see Launch an instance) and choose Create instance.

Your available images are also listed first, under My images, in the form's Boot image picker, when they are in the chosen region and match the instance type's architecture.

Give machineImageId instead of imageId, never both.

When the launch is refused

  • 404 "Machine image not found".
  • 409 "Machine image … is …; only an available image can launch an instance".
  • 409 "The snapshot behind … no longer exists at the provider; deregister the image", or "The snapshot behind … is … at the provider" while it is not available there.
  • 400 "Machine image … is in region …; launch it there".
  • 400 "Machine image … is x86_64; … runs arm64" (the architectures differ).
  • 400 "… has a … GiB disk; … was taken from a … GiB disk and needs at least that much".

Result

The answer is 201 with the instance in state pending, as for any launch. The instance records the image it came from, and an image taken from that instance inherits its OS details. The image works in every zone of its region: to run a copy in another zone, give that zone at launch.

Did this page help you?