LambdaMicroVMs / Client / list_microvm_image_builds

list_microvm_image_builds

LambdaMicroVMs.Client.list_microvm_image_builds(**kwargs)

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.

See also: AWS API Documentation

Request Syntax

response = client.list_microvm_image_builds(
    maxResults=123,
    nextToken='string',
    imageIdentifier='string',
    imageVersion='string',
    architecture='ARM_64',
    chipset='GRAVITON',
    chipsetGeneration='string'
)
Parameters:

  • maxResults (integer) – The maximum number of results to return in a single call.

  • nextToken (string) – The pagination token from a previous call. Use this token to retrieve the next page of results.

  • imageIdentifier (string) –

    [REQUIRED]

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

  • imageVersion (string) –

    [REQUIRED]

    The version of the MicroVM image to list builds for.

  • architecture (string) – Filters builds by target CPU architecture.

  • chipset (string) – Filters builds by target chipset.

  • chipsetGeneration (string) – Filters builds by target chipset generation.

Return type:

dict

Returns:

Response Syntax

{
    'nextToken': 'string',
    'items': [
        {
            'imageArn': 'string',
            'imageVersion': 'string',
            'buildId': 'string',
            'buildState': 'PENDING'|'IN_PROGRESS'|'SUCCESSFUL'|'FAILED',
            'architecture': 'ARM_64',
            'chipset': 'GRAVITON',
            'chipsetGeneration': 'string',
            'stateReason': 'string',
            'createdAt': datetime(2015, 1, 1)
        },
    ]
}

Response Structure

  • (dict) –

    • nextToken (string) –

      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.

    • items (list) –

      The list of MicroVM image builds.

      • (dict) –

        Contains summary information about a MicroVM image build.

        • imageArn (string) –

          The ARN of the MicroVM image.

        • imageVersion (string) –

          The version of the MicroVM image.

        • buildId (string) –

          The build request ID.

        • buildState (string) –

          The current state of the build.

        • architecture (string) –

          The target CPU architecture for the build. Supported value: ARM_64.

        • chipset (string) –

          The target chipset for the build.

        • chipsetGeneration (string) –

          The target chipset generation for the build.

        • stateReason (string) –

          The reason for the build state, if applicable.

        • createdAt (datetime) –

          The timestamp when the build was created.

Exceptions

  • LambdaMicroVMs.Client.exceptions.InternalServerException

  • LambdaMicroVMs.Client.exceptions.AccessDeniedException

  • LambdaMicroVMs.Client.exceptions.ResourceNotFoundException

  • LambdaMicroVMs.Client.exceptions.ThrottlingException

  • LambdaMicroVMs.Client.exceptions.ValidationException