:doc:`CodeBuild <../../codebuild>` / Paginator / ListBuildsForProject

********************
ListBuildsForProject
********************



.. py:class:: CodeBuild.Paginator.ListBuildsForProject

  ::

    
    paginator = client.get_paginator('list_builds_for_project')

  
  

  .. py:method:: paginate(**kwargs)

    Creates an iterator that will paginate through responses from :py:meth:`CodeBuild.Client.list_builds_for_project`.

    See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/ListBuildsForProject>`_    


    **Request Syntax**
    ::

      response_iterator = paginator.paginate(
          projectName='string',
          sortOrder='ASCENDING'|'DESCENDING',
          PaginationConfig={
              'MaxItems': 123,
              'StartingToken': 'string'
          }
      )
      
    :type projectName: string
    :param projectName: **[REQUIRED]** 

      The name of the CodeBuild project.

      

    
    :type sortOrder: string
    :param sortOrder: 

      The order to sort the results in. The results are sorted by build number, not the build identifier. If this is not specified, the results are sorted in descending order.

       

      Valid values include:

       

      
      * ``ASCENDING``: List the build identifiers in ascending order, by build number.
       
      * ``DESCENDING``: List the build identifiers in descending order, by build number.
      

       

      If the project has more than 100 builds, setting the sort order will result in an error.

      

    
    :type PaginationConfig: dict
    :param PaginationConfig: 

      A dictionary that provides parameters to control pagination.

      

    
      - **MaxItems** *(integer) --* 

        The total number of items to return. If the total number of items available is more than the value specified in max-items then a ``NextToken`` will be provided in the output that you can use to resume pagination.

        

      
      - **StartingToken** *(string) --* 

        A token to specify where to start paginating. This is the ``NextToken`` from a previous response.

        

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

      
      ::

        {
            'ids': [
                'string',
            ],
            'NextToken': 'string'
        }
        
      **Response Structure**

      

      - *(dict) --* 
        

        - **ids** *(list) --* 

          A list of build identifiers for the specified build project, with each build ID representing a single build.

          
          

          - *(string) --* 
      
        

        - **NextToken** *(string) --* 

          A token to resume pagination.

          
    