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 maximum items to return in a 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) –

      The next token used for paginated responses. When this field isn’t empty, there are additional elements that the service has’ot included in this request. Use this token with the next request to retrieve additional objects.

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