:doc:`Connect <../../connect>` / Client / list_test_case_executions

*************************
list_test_case_executions
*************************



.. py:method:: Connect.Client.list_test_case_executions(**kwargs)

  

  Lists all test case executions and allows filtering by test case id, test case name, start time, end time or status of the execution for the specified Amazon Connect instance.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/ListTestCaseExecutions>`_  


  **Request Syntax**
  ::

    response = client.list_test_case_executions(
        InstanceId='string',
        TestCaseId='string',
        TestCaseName='string',
        StartTime=datetime(2015, 1, 1),
        EndTime=datetime(2015, 1, 1),
        Status='INITIATED'|'PASSED'|'FAILED'|'IN_PROGRESS'|'STOPPED',
        NextToken='string',
        MaxResults=123
    )
    
  :type InstanceId: string
  :param InstanceId: **[REQUIRED]** 

    The identifier of the Amazon Connect instance.

    

  
  :type TestCaseId: string
  :param TestCaseId: 

    Filter executions by test case identifier.

    

  
  :type TestCaseName: string
  :param TestCaseName: 

    Filter executions by test case name.

    

  
  :type StartTime: datetime
  :param StartTime: 

    Filter executions that started after this time.

    

  
  :type EndTime: datetime
  :param EndTime: 

    Filter executions that started before this time.

    

  
  :type Status: string
  :param Status: 

    Filter executions by status.

    

  
  :type NextToken: string
  :param NextToken: 

    The token for the next set of results. Use the value returned in the previous response in the next request to retrieve the next set of results.

    

  
  :type MaxResults: integer
  :param MaxResults: 

    The maximum number of results to return per page.

    

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

    
    ::

      {
          'TestCaseExecutions': [
              {
                  'StartTime': datetime(2015, 1, 1),
                  'EndTime': datetime(2015, 1, 1),
                  'TestCaseExecutionId': 'string',
                  'TestCaseId': 'string',
                  'TestCaseExecutionStatus': 'INITIATED'|'PASSED'|'FAILED'|'IN_PROGRESS'|'STOPPED',
                  'Tags': {
                      'string': 'string'
                  }
              },
          ],
          'NextToken': 'string'
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **TestCaseExecutions** *(list) --* 

        An array of test case execution summary objects.

        
        

        - *(dict) --* 

          Contains information about a test case execution.

          
          

          - **StartTime** *(datetime) --* 

            The timestamp when the test case execution started.

            
          

          - **EndTime** *(datetime) --* 

            The timestamp when the test case execution ended.

            
          

          - **TestCaseExecutionId** *(string) --* 

            The identifier of the test case execution.

            
          

          - **TestCaseId** *(string) --* 

            The identifier of the test case.

            
          

          - **TestCaseExecutionStatus** *(string) --* 

            The status of the test case execution.

            
          

          - **Tags** *(dict) --* 

            The tags used to organize, track, or control access for this resource.

            
            

            - *(string) --* 
              

              - *(string) --* 
        
      
      
    
      

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

        If there are additional results, this is the token for the next set of results.

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

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

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

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

  
  *   :py:class:`Connect.Client.exceptions.InternalServiceException`

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

  