:doc:`EKS <../../eks>` / Client / list_addons

***********
list_addons
***********



.. py:method:: EKS.Client.list_addons(**kwargs)

  

  Lists the installed add-ons.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/eks-2017-11-01/ListAddons>`_  


  **Request Syntax**
  ::

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

    The name of your cluster.

    

  
  :type maxResults: integer
  :param maxResults: 

    The maximum number of results, returned in paginated output. You receive ``maxResults`` in a single page, along with a ``nextToken`` response element. You can see the remaining results of the initial request by sending another request with the returned ``nextToken`` value. This value can be between 1 and 100. If you don't use this parameter, 100 results and a ``nextToken`` value, if applicable, are returned.

    

  
  :type nextToken: string
  :param nextToken: 

    The ``nextToken`` value returned from a previous paginated request, where ``maxResults`` was used and the results exceeded the value of that parameter. Pagination continues from the end of the previous results that returned the ``nextToken`` value. This value is null when there are no more results to return.

     

    .. note::

      

      This token should be treated as an opaque identifier that is used only to retrieve the next items in a list and not for other programmatic purposes.

      

    

  
  
  :rtype: dict
  :returns: 
    
    **Response Syntax**

    
    ::

      {
          'addons': [
              'string',
          ],
          'nextToken': 'string'
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **addons** *(list) --* 

        A list of installed add-ons.

        
        

        - *(string) --* 
    
      

      - **nextToken** *(string) --* 

        The ``nextToken`` value to include in a future ``ListAddons`` request. When the results of a ``ListAddons`` request exceed ``maxResults``, you can use this value to retrieve the next page of results. This value is ``null`` when there are no more results to return.

         

        .. note::

          

          This token should be treated as an opaque identifier that is used only to retrieve the next items in a list and not for other programmatic purposes.

          

        
  
  **Exceptions**
  
  *   :py:class:`EKS.Client.exceptions.InvalidParameterException`

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

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

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

  
  *   :py:class:`EKS.Client.exceptions.ServerException`

  