v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1424154118.9 KB

Lists builds for a MicroVM image version with optional filtering by architecture and chipset. We recommend using pagination to ensure that the operation returns quickly and successfully.

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

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 list builds for.

Query parameters

maxResultsinteger

The maximum number of results to return in a single call.

nextTokenstring

The pagination token from a previous call. Use this token to retrieve the next page of results.

architecture'ARM_64'

Filters builds by target CPU architecture.

chipset'GRAVITON'

Filters builds by target chipset.

chipsetGenerationstring

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

Filters builds by target chipset generation.

Response

Success

nextTokenstring

The pagination token to use in a subsequent request to retrieve the next page of results. This value is null when there are no more results to return.