LambdaMicroVMs / Client / get_microvm_image_build

get_microvm_image_build

LambdaMicroVMs.Client.get_microvm_image_build(**kwargs)

Retrieves the details of a specific MicroVM image build, including its state, target architecture, and snapshot information.

See also: AWS API Documentation

Request Syntax

response = client.get_microvm_image_build(
    imageIdentifier='string',
    imageVersion='string',
    buildId='string'
)

Parameters:

• imageIdentifier (string) –

  [REQUIRED]

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

• imageVersion (string) –

  [REQUIRED]

  The version of the MicroVM image.

• buildId (string) –

  [REQUIRED]

  The unique identifier of the build to retrieve.

Return type:

dict

Returns:

Response Syntax

{
    '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),
    'snapshotBuild': {
        'memorySnapshotSizeInBytes': 123,
        'codeInstallSizeInBytes': 123,
        'diskSnapshotSizeInBytes': 123
    }
}

Response Structure

• (dict) –

  • 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.

  • snapshotBuild (dict) –

    The snapshot build details, including memory and disk snapshot sizes.

    • memorySnapshotSizeInBytes (integer) –

      The size of the memory snapshot in bytes.

    • codeInstallSizeInBytes (integer) –

      The size of the installed code in bytes.

    • diskSnapshotSizeInBytes (integer) –

      The size of the disk snapshot in bytes.

Exceptions

• LambdaMicroVMs.Client.exceptions.InternalServerException

• LambdaMicroVMs.Client.exceptions.AccessDeniedException

• LambdaMicroVMs.Client.exceptions.ResourceNotFoundException

• LambdaMicroVMs.Client.exceptions.ThrottlingException

• LambdaMicroVMs.Client.exceptions.ValidationException