:doc:`Lambda <../../lambda>` / Client / list_durable_executions_by_function

***********************************
list_durable_executions_by_function
***********************************



.. py:method:: Lambda.Client.list_durable_executions_by_function(**kwargs)

  

  Returns a list of `durable executions <https://docs.aws.amazon.com/lambda/latest/dg/durable-functions.html>`__ for a specified Lambda function. You can filter the results by execution name, status, and start time range. This API supports pagination for large result sets.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/lambda-2015-03-31/ListDurableExecutionsByFunction>`_  


  **Request Syntax**
  ::

    response = client.list_durable_executions_by_function(
        FunctionName='string',
        Qualifier='string',
        DurableExecutionName='string',
        Statuses=[
            'RUNNING'|'SUCCEEDED'|'FAILED'|'TIMED_OUT'|'STOPPED',
        ],
        StartedAfter=datetime(2015, 1, 1),
        StartedBefore=datetime(2015, 1, 1),
        ReverseOrder=True|False,
        Marker='string',
        MaxItems=123
    )
    
  :type FunctionName: string
  :param FunctionName: **[REQUIRED]** 

    The name or ARN of the Lambda function. You can specify a function name, a partial ARN, or a full ARN.

    

  
  :type Qualifier: string
  :param Qualifier: 

    The function version or alias. If not specified, lists executions for the $LATEST version.

    

  
  :type DurableExecutionName: string
  :param DurableExecutionName: 

    Filter executions by name. Only executions with names that contain this string are returned.

    

  
  :type Statuses: list
  :param Statuses: 

    Filter executions by status. Valid values: RUNNING, SUCCEEDED, FAILED, TIMED_OUT, STOPPED.

    

  
    - *(string) --* 

    

  :type StartedAfter: datetime
  :param StartedAfter: 

    Filter executions that started after this timestamp (ISO 8601 format).

    

  
  :type StartedBefore: datetime
  :param StartedBefore: 

    Filter executions that started before this timestamp (ISO 8601 format).

    

  
  :type ReverseOrder: boolean
  :param ReverseOrder: 

    Set to true to return results in reverse chronological order (newest first). Default is false.

    

  
  :type Marker: string
  :param Marker: 

    Pagination token from a previous request to continue retrieving results.

    

  
  :type MaxItems: integer
  :param MaxItems: 

    Maximum number of executions to return (1-1000). Default is 100.

    

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

    
    ::

      {
          'DurableExecutions': [
              {
                  'DurableExecutionArn': 'string',
                  'DurableExecutionName': 'string',
                  'FunctionArn': 'string',
                  'Status': 'RUNNING'|'SUCCEEDED'|'FAILED'|'TIMED_OUT'|'STOPPED',
                  'StartTimestamp': datetime(2015, 1, 1),
                  'EndTimestamp': datetime(2015, 1, 1)
              },
          ],
          'NextMarker': 'string'
      }
      
    **Response Structure**

    

    - *(dict) --* 

      The response from the ListDurableExecutionsByFunction operation, containing a list of durable executions and pagination information.

      
      

      - **DurableExecutions** *(list) --* 

        List of durable execution summaries matching the filter criteria.

        
        

        - *(dict) --* 

          Information about a `durable execution <https://docs.aws.amazon.com/lambda/latest/dg/durable-functions.html>`__.

          
          

          - **DurableExecutionArn** *(string) --* 

            The Amazon Resource Name (ARN) of the durable execution, if this execution is a durable execution.

            
          

          - **DurableExecutionName** *(string) --* 

            The unique name of the durable execution, if one was provided when the execution was started.

            
          

          - **FunctionArn** *(string) --* 

            The Amazon Resource Name (ARN) of the Lambda function.

            
          

          - **Status** *(string) --* 

            The current status of the durable execution.

            
          

          - **StartTimestamp** *(datetime) --* 

            The date and time when the durable execution started, in `ISO-8601 format <https://www.w3.org/TR/NOTE-datetime>`__ (YYYY-MM-DDThh:mm:ss.sTZD).

            
          

          - **EndTimestamp** *(datetime) --* 

            The date and time when the durable execution ended, in `ISO-8601 format <https://www.w3.org/TR/NOTE-datetime>`__ (YYYY-MM-DDThh:mm:ss.sTZD).

            
      
    
      

      - **NextMarker** *(string) --* 

        Pagination token for retrieving additional results. Present only if there are more results available.

        
  
  **Exceptions**
  
  *   :py:class:`Lambda.Client.exceptions.InvalidParameterValueException`

  
  *   :py:class:`Lambda.Client.exceptions.TooManyRequestsException`

  
  *   :py:class:`Lambda.Client.exceptions.ServiceException`

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

  