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.

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) –
    
    A software package that’s installed on top of the base image to create a customized image.
    - packageName (string) –
      
      The name of the package that’s reported to the operating system package manager.
    - packageVersion (string) –
      
      The version of the package that’s 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 hasn’t 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