:doc:`DataZone <../../datazone>` / Client / list_data_source_runs

*********************
list_data_source_runs
*********************



.. py:method:: DataZone.Client.list_data_source_runs(**kwargs)

  

  Lists data source runs in Amazon DataZone.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/datazone-2018-05-10/ListDataSourceRuns>`_  


  **Request Syntax**
  ::

    response = client.list_data_source_runs(
        domainIdentifier='string',
        dataSourceIdentifier='string',
        status='REQUESTED'|'RUNNING'|'FAILED'|'PARTIALLY_SUCCEEDED'|'SUCCESS',
        nextToken='string',
        maxResults=123
    )
    
  :type domainIdentifier: string
  :param domainIdentifier: **[REQUIRED]** 

    The identifier of the Amazon DataZone domain in which to invoke the ``ListDataSourceRuns`` action.

    

  
  :type dataSourceIdentifier: string
  :param dataSourceIdentifier: **[REQUIRED]** 

    The identifier of the data source.

    

  
  :type status: string
  :param status: 

    The status of the data source.

    

  
  :type nextToken: string
  :param nextToken: 

    When the number of runs is greater than the default value for the ``MaxResults`` parameter, or if you explicitly specify a value for ``MaxResults`` that is less than the number of runs, the response includes a pagination token named ``NextToken``. You can specify this ``NextToken`` value in a subsequent call to ``ListDataSourceRuns`` to list the next set of runs.

    

  
  :type maxResults: integer
  :param maxResults: 

    The maximum number of runs to return in a single call to ``ListDataSourceRuns``. When the number of runs to be listed is greater than the value of ``MaxResults``, the response contains a ``NextToken`` value that you can use in a subsequent call to ``ListDataSourceRuns`` to list the next set of runs.

    

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

    
    ::

      {
          'items': [
              {
                  'id': 'string',
                  'dataSourceId': 'string',
                  'type': 'PRIORITIZED'|'SCHEDULED',
                  'status': 'REQUESTED'|'RUNNING'|'FAILED'|'PARTIALLY_SUCCEEDED'|'SUCCESS',
                  'projectId': 'string',
                  'runStatisticsForAssets': {
                      'added': 123,
                      'updated': 123,
                      'unchanged': 123,
                      'skipped': 123,
                      'failed': 123
                  },
                  'errorMessage': {
                      'errorType': 'ACCESS_DENIED_EXCEPTION'|'CONFLICT_EXCEPTION'|'INTERNAL_SERVER_EXCEPTION'|'RESOURCE_NOT_FOUND_EXCEPTION'|'SERVICE_QUOTA_EXCEEDED_EXCEPTION'|'THROTTLING_EXCEPTION'|'VALIDATION_EXCEPTION',
                      'errorDetail': 'string'
                  },
                  'createdAt': datetime(2015, 1, 1),
                  'updatedAt': datetime(2015, 1, 1),
                  'startedAt': datetime(2015, 1, 1),
                  'stoppedAt': datetime(2015, 1, 1),
                  'lineageSummary': {
                      'importStatus': 'IN_PROGRESS'|'SUCCESS'|'FAILED'|'PARTIALLY_SUCCEEDED'
                  }
              },
          ],
          'nextToken': 'string'
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **items** *(list) --* 

        The results of the ``ListDataSourceRuns`` action.

        
        

        - *(dict) --* 

          The details of a data source run.

          
          

          - **id** *(string) --* 

            The identifier of the data source run.

            
          

          - **dataSourceId** *(string) --* 

            The identifier of the data source of the data source run.

            
          

          - **type** *(string) --* 

            The type of the data source run.

            
          

          - **status** *(string) --* 

            The status of the data source run.

            
          

          - **projectId** *(string) --* 

            The project ID of the data source run.

            
          

          - **runStatisticsForAssets** *(dict) --* 

            The asset statistics from the data source run.

            
            

            - **added** *(integer) --* 

              The ``added`` statistic for the data source run.

              
            

            - **updated** *(integer) --* 

              The ``updated`` statistic for the data source run.

              
            

            - **unchanged** *(integer) --* 

              The ``unchanged`` statistic for the data source run.

              
            

            - **skipped** *(integer) --* 

              The ``skipped`` statistic for the data source run.

              
            

            - **failed** *(integer) --* 

              The ``failed`` statistic for the data source run.

              
        
          

          - **errorMessage** *(dict) --* 

            The details of the error message that is returned if the operation cannot be successfully completed.

            
            

            - **errorType** *(string) --* 

              The type of the error message that is returned if the operation cannot be successfully completed.

              
            

            - **errorDetail** *(string) --* 

              The details of the error message that is returned if the operation cannot be successfully completed.

              
        
          

          - **createdAt** *(datetime) --* 

            The timestamp of when a data source run was created.

            
          

          - **updatedAt** *(datetime) --* 

            The timestamp of when a data source run was updated.

            
          

          - **startedAt** *(datetime) --* 

            The timestamp of when a data source run was started.

            
          

          - **stoppedAt** *(datetime) --* 

            The timestamp of when a data source run was stopped.

            
          

          - **lineageSummary** *(dict) --* 

            The run lineage summary of a data source.

            
            

            - **importStatus** *(string) --* 

              The import status that's part of the run lineage summary of a data source.

              
        
      
    
      

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

        When the number of runs is greater than the default value for the ``MaxResults`` parameter, or if you explicitly specify a value for ``MaxResults`` that is less than the number of runs, the response includes a pagination token named ``NextToken``. You can specify this ``NextToken`` value in a subsequent call to ``ListDataSourceRuns`` to list the next set of runs.

        
  
  **Exceptions**
  
  *   :py:class:`DataZone.Client.exceptions.InternalServerException`

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

  
  *   :py:class:`DataZone.Client.exceptions.AccessDeniedException`

  
  *   :py:class:`DataZone.Client.exceptions.ThrottlingException`

  
  *   :py:class:`DataZone.Client.exceptions.ServiceQuotaExceededException`

  
  *   :py:class:`DataZone.Client.exceptions.ConflictException`

  
  *   :py:class:`DataZone.Client.exceptions.ValidationException`

  
  *   :py:class:`DataZone.Client.exceptions.UnauthorizedException`

  