:doc:`imagebuilder <../../imagebuilder>` / Client / list_image_packages

*******************
list_image_packages
*******************



.. py:method:: 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 <https://docs.aws.amazon.com/goto/WebAPI/imagebuilder-2019-12-02/ListImagePackages>`_  


  **Request Syntax**
  ::

    response = client.list_image_packages(
        imageBuildVersionArn='string',
        maxResults=123,
        nextToken='string'
    )
    
  :type imageBuildVersionArn: string
  :param imageBuildVersionArn: **[REQUIRED]** 

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

    

  
  :type maxResults: integer
  :param maxResults: 

    Specify the maximum number of items to return in a request.

    

  
  :type nextToken: string
  :param nextToken: 

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

    

  
  
  :rtype: 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**
  
  *   :py:class:`imagebuilder.Client.exceptions.ServiceException`

  
  *   :py:class:`imagebuilder.Client.exceptions.ClientException`

  
  *   :py:class:`imagebuilder.Client.exceptions.ServiceUnavailableException`

  
  *   :py:class:`imagebuilder.Client.exceptions.InvalidRequestException`

  
  *   :py:class:`imagebuilder.Client.exceptions.InvalidPaginationTokenException`

  
  *   :py:class:`imagebuilder.Client.exceptions.ResourceNotFoundException`

  
  *   :py:class:`imagebuilder.Client.exceptions.ForbiddenException`

  
  *   :py:class:`imagebuilder.Client.exceptions.CallRateLimitExceededException`

  