imagebuilder / Client / list_image_packages

list_image_packages#

imagebuilder.Client.list_image_packages(**kwargs)#

List the Packages that are associated with an Image Build Version, as determined by Amazon Web Services Systems Manager Inventory at build time.

See also: AWS API Documentation

Request Syntax

response = client.list_image_packages(
    imageBuildVersionArn='string',
    maxResults=123,
    nextToken='string'
)
Parameters:

  • imageBuildVersionArn (string) –

    [REQUIRED]

    Filter results for the ListImagePackages request by the Image Build Version ARN

  • maxResults (integer) – The maxiumum number of results to return from the ListImagePackages request.

  • nextToken (string) – A token to specify where to start paginating. This is the NextToken from a previously truncated response.

Return type:

dict

Returns:

Response Syntax

{
    'requestId': 'string',
    'imagePackageList': [
        {
            'packageName': 'string',
            'packageVersion': 'string'
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) –

    • requestId (string) –

      The request ID that uniquely identifies this request.

    • imagePackageList (list) –

      The list of Image Packages returned in the response.

      • (dict) –

        Represents a package installed on an Image Builder image.

        • packageName (string) –

          The name of the package as reported to the operating system package manager.

        • packageVersion (string) –

          The version of the package as reported to the operating system package manager.

    • nextToken (string) –

      A token to specify where to start paginating. This is the NextToken from a previously truncated response.

Exceptions

  • imagebuilder.Client.exceptions.ServiceException

  • imagebuilder.Client.exceptions.ClientException

  • imagebuilder.Client.exceptions.ServiceUnavailableException

  • imagebuilder.Client.exceptions.InvalidRequestException

  • imagebuilder.Client.exceptions.InvalidPaginationTokenException

  • imagebuilder.Client.exceptions.ResourceNotFoundException

  • imagebuilder.Client.exceptions.ForbiddenException

  • imagebuilder.Client.exceptions.CallRateLimitExceededException