listMicrovmImageBuilds method
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.
May throw AccessDeniedException.
May throw InternalServerException.
May throw ResourceNotFoundException.
May throw ThrottlingException.
May throw ValidationException.
Parameter imageIdentifier :
The unique identifier (ARN or ID) of the MicroVM image.
Parameter imageVersion :
The version of the MicroVM image to list builds for.
Parameter architecture :
Filters builds by target CPU architecture.
Parameter chipset :
Filters builds by target chipset.
Parameter chipsetGeneration :
Filters builds by target chipset generation.
Parameter maxResults :
The maximum number of results to return in a single call.
Parameter nextToken :
The pagination token from a previous call. Use this token to retrieve the
next page of results.
Implementation
Future<ListMicrovmImageBuildsOutput> listMicrovmImageBuilds({
required String imageIdentifier,
required String imageVersion,
Architecture? architecture,
Chipset? chipset,
String? chipsetGeneration,
int? maxResults,
String? nextToken,
}) async {
final $query = <String, List<String>>{
if (architecture != null) 'architecture': [architecture.value],
if (chipset != null) 'chipset': [chipset.value],
if (chipsetGeneration != null) 'chipsetGeneration': [chipsetGeneration],
if (maxResults != null) 'maxResults': [maxResults.toString()],
if (nextToken != null) 'nextToken': [nextToken],
};
final response = await _protocol.send(
payload: null,
method: 'GET',
requestUri:
'/2025-09-09/microvm-images/${Uri.encodeComponent(imageIdentifier)}/versions/${Uri.encodeComponent(imageVersion)}/builds',
queryParams: $query,
exceptionFnMap: _exceptionFns,
);
return ListMicrovmImageBuildsOutput.fromJson(response);
}