Skip to content

list_microvm_image_builds

list_microvm_image_builds(
    image_identifier: MicrovmImageIdentifier,
    image_version: NonBlankString,
    *,
    config_overrides: Optional[LambdaMicrovmsClientConfig] = None,
    max_results: Optional[int] = None,
    next_token: Optional[String] = None,
    architecture: Optional[Architecture] = None,
    chipset: Optional[Chipset] = None,
    chipset_generation: Optional[NonBlankString] = None,
) -> ListMicrovmImageBuildsOutput

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.

Parameters:

  • max_results (Optional[int], default: None ) –

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

  • next_token (Optional[String], default: None ) –

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

  • image_identifier (MicrovmImageIdentifier) –

    The unique identifier (ARN or ID) of the MicroVM image.

  • image_version (NonBlankString) –

    The version of the MicroVM image to list builds for.

  • architecture (Optional[Architecture], default: None ) –

    Filters builds by target CPU architecture.

  • chipset (Optional[Chipset], default: None ) –

    Filters builds by target chipset.

  • chipset_generation (Optional[NonBlankString], default: None ) –

    Filters builds by target chipset generation.

Raises:

Source code in docs_src/capo_lambda_microvms/_services/lambda_microvms.py
def list_microvm_image_builds(
    self,
    image_identifier: "capo_lambda_microvms.types.microvm_image_identifier.MicrovmImageIdentifier",
    image_version: "capo_lambda_microvms.types.non_blank_string.NonBlankString",
    *,
    config_overrides: Optional[LambdaMicrovmsClientConfig] = None,
    max_results: Optional[int] = None,
    next_token: Optional["capo_lambda_microvms.types.string.String"] = None,
    architecture: Optional[
        "capo_lambda_microvms.types.architecture.Architecture"
    ] = None,
    chipset: Optional["capo_lambda_microvms.types.chipset.Chipset"] = None,
    chipset_generation: Optional[
        "capo_lambda_microvms.types.non_blank_string.NonBlankString"
    ] = None,
) -> "capo_lambda_microvms.types.list_microvm_image_builds_output.ListMicrovmImageBuildsOutput":
    """<p>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.</p>

    Args:
        max_results: <p>The maximum number of results to return in a single call.</p>
        next_token: <p>The pagination token from a previous call. Use this token to retrieve the next page of results.</p>
        image_identifier: <p>The unique identifier (ARN or ID) of the MicroVM image.</p>
        image_version: <p>The version of the MicroVM image to list builds for.</p>
        architecture: <p>Filters builds by target CPU architecture.</p>
        chipset: <p>Filters builds by target chipset.</p>
        chipset_generation: <p>Filters builds by target chipset generation.</p>

    Raises:
        capo_lambda_microvms.errors.access_denied_exception.AccessDeniedException: <p>You do not have sufficient access to perform this action.</p>
        capo_lambda_microvms.errors.internal_server_exception.InternalServerException: <p>An internal server error occurred. Retry the request later.</p>
        capo_lambda_microvms.errors.throttling_exception.ThrottlingException: <p>The request was denied due to request throttling. Retry the request later.</p>
        capo_lambda_microvms.errors.validation_exception.ValidationException: <p>The input does not satisfy the constraints specified by the service.</p>
        capo_lambda_microvms.errors.resource_not_found_exception.ResourceNotFoundException: <p>The specified resource does not exist.</p>
        capo_lambda_microvms.errors.UnknownServiceError: The service returned an error code this client does not model.
    """

    def _handler(
        req: "OperationRequest[capo_lambda_microvms.types.list_microvm_image_builds_input.ListMicrovmImageBuildsInput]",
    ) -> OperationResponse[
        "capo_lambda_microvms.types.list_microvm_image_builds_output.ListMicrovmImageBuildsOutput"
    ]:
        import capo_lambda_microvms._operations.lambda_microvms.list_microvm_image_builds

        output, http_response = (
            capo_lambda_microvms._operations.lambda_microvms.list_microvm_image_builds.list_microvm_image_builds(
                req.options, req.input
            )
        )
        return OperationResponse(output=output, response=http_response)

    interceptors_, options_ = self.operation_options(
        config_overrides, OperationLogging("ListMicrovmImageBuilds")
    )
    input_: capo_lambda_microvms.types.list_microvm_image_builds_input.ListMicrovmImageBuildsInput = {
        "image_identifier": image_identifier,
        "image_version": image_version,
    }
    if max_results is not None:
        input_["max_results"] = max_results
    if next_token is not None:
        input_["next_token"] = next_token
    if architecture is not None:
        input_["architecture"] = architecture
    if chipset is not None:
        input_["chipset"] = chipset
    if chipset_generation is not None:
        input_["chipset_generation"] = chipset_generation

    response = execute_pipeline(
        OperationRequest(input=input_, options=options_),
        handler=_handler,
        interceptors=list(interceptors_),
    )
    response.response.close()
    return response.output